ConstraintCollection.Add Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Data

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Aggiunge un oggetto Constraint alla raccolta.

Overload

Add(Constraint)	Aggiunge l'oggetto Constraint specificato alla raccolta.
Add(String, DataColumn, Boolean)	Costruisce una nuova classe UniqueConstraint con il nome specificato, la classe DataColumn e un valore che indica se la colonna è una chiave primaria, eseguendone l'aggiunta all'insieme.
Add(String, DataColumn, DataColumn)	Crea un nuovo oggetto ForeignKeyConstraint con il nome specificato, la colonna padre e la colonna figlio e aggiunge il vincolo all'insieme.
Add(String, DataColumn[], Boolean)	Costruisce una nuova classe UniqueConstraint con nome, matrice di oggetti DataColumn e valore specificati, che indica se la colonna è una chiave primaria, e ne esegue l'aggiunta all'insieme.
Add(String, DataColumn[], DataColumn[])	Crea un nuovo oggetto ForeignKeyConstraint con le matrici specificate di colonne padre e colonne figlio e aggiunge il vincolo all'insieme.

Add(Constraint)

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Aggiunge l'oggetto Constraint specificato alla raccolta.

public:
 void Add(System::Data::Constraint ^ constraint);

public void Add (System.Data.Constraint constraint);

member this.Add : System.Data.Constraint -> unit

Public Sub Add (constraint As Constraint)

Parametri

constraint: Constraint

Oggetto Constraint da aggiungere.

Eccezioni

ArgumentNullException

L'argomento constraint è Null.

ArgumentException

Il vincolo appartiene già alla raccolta o appartiene a un'altra raccolta.

DuplicateNameException

La raccolta ha già un vincolo con lo stesso nome. Nel confronto non viene fatta distinzione tra maiuscole e minuscole.

Esempio

Nell'esempio seguente viene aggiunto un UniqueConstraint oggetto all'oggetto ConstraintCollection di un oggetto DataTable.

private void AddConstraint(DataTable table)
{
    UniqueConstraint uniqueConstraint;
    // Assuming a column named "UniqueColumn" exists, and
    // its Unique property is true.
    uniqueConstraint = new UniqueConstraint(
        table.Columns["UniqueColumn"]);
    table.Constraints.Add(uniqueConstraint);
}

Private Sub AddConstraint(table As DataTable)
    Dim uniqueConstraint As UniqueConstraint
    ' Assuming a column named "UniqueColumn" exists, and 
    ' its Unique property is true.
    uniqueConstraint = _
       New UniqueConstraint(table.Columns("UniqueColumn"))
    table.Constraints.Add(uniqueConstraint)
End Sub

Commenti

Se la raccolta viene modificata aggiungendo o rimuovendo vincoli, l'evento CollectionChanged si verifica.

Vedi anche

Si applica a

Add(String, DataColumn, Boolean)

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Costruisce una nuova classe UniqueConstraint con il nome specificato, la classe DataColumn e un valore che indica se la colonna è una chiave primaria, eseguendone l'aggiunta all'insieme.

public:
 System::Data::Constraint ^ Add(System::String ^ name, System::Data::DataColumn ^ column, bool primaryKey);

public:
 virtual System::Data::Constraint ^ Add(System::String ^ name, System::Data::DataColumn ^ column, bool primaryKey);

public System.Data.Constraint Add (string? name, System.Data.DataColumn column, bool primaryKey);

public System.Data.Constraint Add (string name, System.Data.DataColumn column, bool primaryKey);

public virtual System.Data.Constraint Add (string name, System.Data.DataColumn column, bool primaryKey);

member this.Add : string * System.Data.DataColumn * bool -> System.Data.Constraint

abstract member Add : string * System.Data.DataColumn * bool -> System.Data.Constraint
override this.Add : string * System.Data.DataColumn * bool -> System.Data.Constraint

Public Function Add (name As String, column As DataColumn, primaryKey As Boolean) As Constraint

Public Overridable Function Add (name As String, column As DataColumn, primaryKey As Boolean) As Constraint

Parametri

name: String

Nome di UniqueConstraint.

column: DataColumn

Oggetto DataColumn a cui viene applicato il vincolo.

primaryKey: Boolean

Specifica se la colonna deve essere la chiave primaria. Se true, la colonna è una colonna di chiave primaria.

Restituisce

Constraint

Nuovo oggetto UniqueConstraint.

Eccezioni

ArgumentException

Il vincolo appartiene già a questo insieme.

Oppure

Il vincolo appartiene a un altro insieme.

DuplicateNameException

L'insieme dispone già di un vincolo con il nome specificato. Nel confronto non viene fatta distinzione tra maiuscole e minuscole.

Esempio

Nell'esempio seguente viene usato il Add metodo per creare e aggiungere un nuovo UniqueConstraint oggetto a un oggetto ConstraintCollection.

private void AddUniqueConstraint(DataTable table){
   table.Constraints.Add("idConstraint", table.Columns["id"], true);
}

Private Sub AddUniqueConstraint(table As DataTable)
    table.Constraints.Add("idConstraint", table.Columns("id"), True)
End Sub

Commenti

L'evento CollectionChanged si verifica se il vincolo viene aggiunto correttamente.

Vedi anche

UniqueConstraint

Si applica a

Add(String, DataColumn, DataColumn)

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Crea un nuovo oggetto ForeignKeyConstraint con il nome specificato, la colonna padre e la colonna figlio e aggiunge il vincolo all'insieme.

public:
 System::Data::Constraint ^ Add(System::String ^ name, System::Data::DataColumn ^ primaryKeyColumn, System::Data::DataColumn ^ foreignKeyColumn);

public:
 virtual System::Data::Constraint ^ Add(System::String ^ name, System::Data::DataColumn ^ primaryKeyColumn, System::Data::DataColumn ^ foreignKeyColumn);

public System.Data.Constraint Add (string? name, System.Data.DataColumn primaryKeyColumn, System.Data.DataColumn foreignKeyColumn);

public System.Data.Constraint Add (string name, System.Data.DataColumn primaryKeyColumn, System.Data.DataColumn foreignKeyColumn);

public virtual System.Data.Constraint Add (string name, System.Data.DataColumn primaryKeyColumn, System.Data.DataColumn foreignKeyColumn);

member this.Add : string * System.Data.DataColumn * System.Data.DataColumn -> System.Data.Constraint

abstract member Add : string * System.Data.DataColumn * System.Data.DataColumn -> System.Data.Constraint
override this.Add : string * System.Data.DataColumn * System.Data.DataColumn -> System.Data.Constraint

Public Function Add (name As String, primaryKeyColumn As DataColumn, foreignKeyColumn As DataColumn) As Constraint

Public Overridable Function Add (name As String, primaryKeyColumn As DataColumn, foreignKeyColumn As DataColumn) As Constraint

Parametri

name: String

Nome di ForeignKeyConstraint.

primaryKeyColumn: DataColumn

Oggetto DataColumn di chiave primaria o padre.

foreignKeyColumn: DataColumn

Oggetto DataColumn di chiave esterna o figlio.

Restituisce

Constraint

Nuovo oggetto ForeignKeyConstraint.

Esempio

Nell'esempio seguente viene aggiunto un nuovo ForeignKeyConstraint oggetto all'oggetto di un oggetto ConstraintCollection DataTable.

private void AddForeignConstraint(DataSet dataSet)
{
    try
    {
        DataColumn parentColumn =
            dataSet.Tables["Suppliers"].Columns["SupplierID"];
        DataColumn childColumn =
            dataSet.Tables["Products"].Columns["SupplierID"];
        dataSet.Tables["Products"].Constraints.Add
            ("ProductsSuppliers", parentColumn, childColumn);
    }
    catch(Exception ex)
    {
        // In case the constraint already exists,
        // catch the collision here and respond.
        Console.WriteLine("Exception of type {0} occurred.",
            ex.GetType());
    }
}

Private Sub AddForeignConstraint(dataSet As DataSet)
    Try
        Dim parentColumn As DataColumn = _
            dataSet.Tables("Suppliers").Columns("SupplierID")
        Dim childColumn As DataColumn = _
            dataSet.Tables("Products").Columns("SupplierID")
        dataSet.Tables("Products").Constraints.Add _
            ("ProductsSuppliers", parentColumn, childColumn)
        
    Catch ex As Exception
        ' In case the constraint already exists, 
        ' catch the collision here and respond.
        Console.WriteLine("Exception of type {0} occurred.", _
            ex.GetType().ToString())
    End Try
End Sub

Commenti

L'evento CollectionChanged si verifica se il vincolo viene aggiunto correttamente.

Si applica a

Add(String, DataColumn[], Boolean)

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Costruisce una nuova classe UniqueConstraint con nome, matrice di oggetti DataColumn e valore specificati, che indica se la colonna è una chiave primaria, e ne esegue l'aggiunta all'insieme.

public:
 System::Data::Constraint ^ Add(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ columns, bool primaryKey);

public:
 virtual System::Data::Constraint ^ Add(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ columns, bool primaryKey);

public System.Data.Constraint Add (string? name, System.Data.DataColumn[] columns, bool primaryKey);

public System.Data.Constraint Add (string name, System.Data.DataColumn[] columns, bool primaryKey);

public virtual System.Data.Constraint Add (string name, System.Data.DataColumn[] columns, bool primaryKey);

member this.Add : string * System.Data.DataColumn[] * bool -> System.Data.Constraint

abstract member Add : string * System.Data.DataColumn[] * bool -> System.Data.Constraint
override this.Add : string * System.Data.DataColumn[] * bool -> System.Data.Constraint

Public Function Add (name As String, columns As DataColumn(), primaryKey As Boolean) As Constraint

Public Overridable Function Add (name As String, columns As DataColumn(), primaryKey As Boolean) As Constraint

Parametri

name: String

Nome di UniqueConstraint.

columns: DataColumn[]

Matrice di oggetti DataColumn a cui viene applicato il vincolo.

primaryKey: Boolean

Specifica se la colonna deve essere la chiave primaria. Se true, la colonna è una colonna di chiave primaria.

Restituisce

Constraint

Nuovo oggetto UniqueConstraint.

Eccezioni

ArgumentException

Il vincolo appartiene già a questo insieme.

Oppure

Il vincolo appartiene a un altro insieme.

DuplicateNameException

L'insieme dispone già di un vincolo con il nome specificato. Nel confronto non viene fatta distinzione tra maiuscole e minuscole.

Esempio

Nell'esempio seguente viene creata una matrice di DataColumn oggetti utilizzati per creare un nuovo UniqueConstraint oggetto in un oggetto specifico DataTable.

private void AddUniqueConstraint(DataTable table)
{
    DataColumn[] columns = new DataColumn[1];
    columns[0] = table.Columns["ID"];
    columns[1] = table.Columns["Name"];
    table.Constraints.Add("idNameConstraint", columns, true);
}

Private Sub AddUniqueConstraint(table As DataTable)
    Dim columns(1) As DataColumn
    columns(0) = table.Columns("ID")
    columns(1) = table.Columns("Name")
    table.Constraints.Add("idNameConstraint", columns, True)
End Sub

Commenti

L'evento CollectionChanged si verifica se il vincolo viene aggiunto correttamente.

Vedi anche

UniqueConstraint

Si applica a

Add(String, DataColumn[], DataColumn[])

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Crea un nuovo oggetto ForeignKeyConstraint con le matrici specificate di colonne padre e colonne figlio e aggiunge il vincolo all'insieme.

public:
 System::Data::Constraint ^ Add(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ primaryKeyColumns, cli::array <System::Data::DataColumn ^> ^ foreignKeyColumns);

public:
 virtual System::Data::Constraint ^ Add(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ primaryKeyColumns, cli::array <System::Data::DataColumn ^> ^ foreignKeyColumns);

public System.Data.Constraint Add (string? name, System.Data.DataColumn[] primaryKeyColumns, System.Data.DataColumn[] foreignKeyColumns);

public System.Data.Constraint Add (string name, System.Data.DataColumn[] primaryKeyColumns, System.Data.DataColumn[] foreignKeyColumns);

public virtual System.Data.Constraint Add (string name, System.Data.DataColumn[] primaryKeyColumns, System.Data.DataColumn[] foreignKeyColumns);

member this.Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.Constraint

abstract member Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.Constraint
override this.Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.Constraint

Public Function Add (name As String, primaryKeyColumns As DataColumn(), foreignKeyColumns As DataColumn()) As Constraint

Public Overridable Function Add (name As String, primaryKeyColumns As DataColumn(), foreignKeyColumns As DataColumn()) As Constraint

Parametri

name: String

Nome di ForeignKeyConstraint.

primaryKeyColumns: DataColumn[]

Matrice di oggetti DataColumn che rappresentano le colonne di chiave primaria o padre.

foreignKeyColumns: DataColumn[]

Matrice di oggetti DataColumn che rappresentano le colonne di chiave esterna o figlio.

Restituisce

Constraint

Nuovo oggetto ForeignKeyConstraint.

Esempio

L'esempio seguente crea due matrici di DataColumn oggetti e quindi crea due relazioni tra due ForeignKeyConstraint tabelle in un set di dati.

private void AddForeignConstraint(
    DataSet dataSet, DataTable table)
{
    try
    {
        DataColumn[] parentColumns = new DataColumn[2];
        DataColumn[] childColumns = new DataColumn[2];
        // Get the tables from the DataSet.
        DataTable customersTable = dataSet.Tables["Customers"];
        DataTable ordersTable = dataSet.Tables["Orders"];

        // Set Columns.
        parentColumns[0]=customersTable.Columns["id"];
        parentColumns[1]=customersTable.Columns["Name"];
        childColumns[0] = ordersTable.Columns["CustomerID"];
        childColumns[1] = ordersTable.Columns["CustomerName"];

        // Create ForeignKeyConstraint
        table.Constraints.Add("CustOrdersConstraint",
            parentColumns, childColumns);
    }
    catch(Exception ex)
    {
        // In case the constraint already exists,
        // catch the collision here and respond.
        Console.WriteLine("Exception of type {0} occurred.",
            ex.GetType());
    }
}

Private Sub AddForeignConstraint( _
ByVal dataSet As DataSet, ByVal table As DataTable)
    Try
        Dim parentColumns(1) As DataColumn
        Dim childColumns(1) As DataColumn
        ' Get the tables from the DataSet.
        Dim customersTable As DataTable = _
            dataSet.Tables("Customers")
        Dim ordersTable As DataTable = _
            dataSet.Tables("Orders")

        ' Set Columns.
        parentColumns(0) = customersTable.Columns("id")
        parentColumns(1) = customersTable.Columns("Name")
        childColumns(0) = ordersTable.Columns("CustomerID")
        childColumns(1) = ordersTable.Columns("CustomerName")

        ' Create ForeignKeyConstraint
        table.Constraints.Add("CustOrdersConstraint", _
            parentColumns, childColumns)

    Catch ex As Exception
        ' In case the constraint already exists, 
        ' catch the collision here and respond.
        Console.WriteLine("Exception of type {0} occurred.", _
            ex.GetType().ToString())
    End Try
End Sub

Commenti

L'evento CollectionChanged si verifica se il vincolo viene aggiunto correttamente.

Si applica a

Condividi tramite

ConstraintCollection.Add Metodo

Definizione

Overload

Add(Constraint)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

Add(String, DataColumn, Boolean)

Parametri

Restituisce

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

Add(String, DataColumn, DataColumn)

Parametri

Restituisce

Esempio

Commenti

Si applica a

Add(String, DataColumn[], Boolean)

Parametri

Restituisce

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

Add(String, DataColumn[], DataColumn[])

Parametri

Restituisce

Esempio

Commenti

Si applica a

Risorse aggiuntive