ConstraintCollection.Add ConstraintCollection.Add ConstraintCollection.Add ConstraintCollection.Add Method

Definizione

Aggiunge un oggetto Constraint alla raccolta.Adds a Constraint object to the collection.

Overload

Add(Constraint) Add(Constraint) Add(Constraint)

Aggiunge l'oggetto Constraint specificato alla raccolta.Adds the specified Constraint object to the collection.

Add(String, DataColumn, Boolean) Add(String, DataColumn, Boolean) Add(String, DataColumn, Boolean) 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.Constructs a new UniqueConstraint with the specified name, DataColumn, and value that indicates whether the column is a primary key, and adds it to the collection.

Add(String, DataColumn, DataColumn) Add(String, DataColumn, DataColumn) Add(String, DataColumn, DataColumn) 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.Constructs a new ForeignKeyConstraint with the specified name, parent column, and child column, and adds the constraint to the collection.

Add(String, DataColumn[], Boolean) Add(String, DataColumn[], Boolean) Add(String, DataColumn[], Boolean) 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.Constructs a new UniqueConstraint with the specified name, array of DataColumn objects, and value that indicates whether the column is a primary key, and adds it to the collection.

Add(String, DataColumn[], DataColumn[]) Add(String, DataColumn[], DataColumn[]) Add(String, DataColumn[], DataColumn[]) 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.Constructs a new ForeignKeyConstraint, with the specified arrays of parent columns and child columns, and adds the constraint to the collection.

Add(Constraint) Add(Constraint) Add(Constraint)

Aggiunge l'oggetto Constraint specificato alla raccolta.Adds the specified Constraint object to the collection.

public:
 void Add(System::Data::Constraint ^ constraint);
public void Add (System.Data.Constraint constraint);
member this.Add : System.Data.Constraint -> unit

Parametri

constraint
Constraint Constraint Constraint Constraint

Oggetto Constraint da aggiungere.The Constraint to add.

Eccezioni

L'argomento constraint è Null.The constraint argument is null.

Il vincolo appartiene già alla raccolta o appartiene a un'altra raccolta.The constraint already belongs to this collection, or belongs to another collection.

La raccolta ha già un vincolo con lo stesso nome.The collection already has a constraint with the same name. Nel confronto non viene fatta distinzione tra maiuscole e minuscole.(The comparison is not case-sensitive.)

Esempi

Nell'esempio seguente viene aggiunto UniqueConstraint un oggetto ConstraintCollection all'oggetto DataTabledi un oggetto.The following example adds a UniqueConstraint to the ConstraintCollection of a 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 correttamente mediante l'aggiunta o la rimozione di CollectionChanged vincoli, si verifica l'evento.If the collection is successfully changed by adding or removing constraints, the CollectionChanged event occurs.

Vedi anche

Add(String, DataColumn, Boolean) Add(String, DataColumn, Boolean) Add(String, DataColumn, Boolean) 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.Constructs a new UniqueConstraint with the specified name, DataColumn, and value that indicates whether the column is a primary key, and adds it to the collection.

public:
 virtual System::Data::Constraint ^ Add(System::String ^ name, System::Data::DataColumn ^ column, bool primaryKey);
public virtual System.Data.Constraint Add (string name, System.Data.DataColumn column, bool primaryKey);
abstract member Add : string * System.Data.DataColumn * bool -> System.Data.Constraint
override this.Add : string * System.Data.DataColumn * bool -> System.Data.Constraint
Public Overridable Function Add (name As String, column As DataColumn, primaryKey As Boolean) As Constraint

Parametri

name
String String String String

Nome di UniqueConstraint.The name of the UniqueConstraint.

column
DataColumn DataColumn DataColumn DataColumn

Oggetto DataColumn a cui viene applicato il vincolo.The DataColumn to which the constraint applies.

primaryKey
Boolean Boolean Boolean Boolean

Specifica se la colonna deve essere la chiave primaria.Specifies whether the column should be the primary key. Se true, la colonna è una colonna di chiave primaria.If true, the column will be a primary key column.

Restituisce

Nuovo oggetto UniqueConstraint.A new UniqueConstraint.

Eccezioni

Il vincolo appartiene già a questo insieme.The constraint already belongs to this collection.

oppure-Or-

Il vincolo appartiene a un altro insieme.The constraint belongs to another collection.

L'insieme dispone già di un vincolo con il nome specificato.The collection already has a constraint with the specified name. Nel confronto non viene fatta distinzione tra maiuscole e minuscole.(The comparison is not case-sensitive.)

Esempi

Nell'esempio seguente viene usato Add il metodo per creare e aggiungere un UniqueConstraint nuovo oggetto ConstraintCollectiona un oggetto.The following example uses the Add method to create and add a new UniqueConstraint to a 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' CollectionChanged evento si verifica se il vincolo viene aggiunto correttamente.The CollectionChanged event occurs if the constraint is added successfully.

Vedi anche

Add(String, DataColumn, DataColumn) Add(String, DataColumn, DataColumn) Add(String, DataColumn, DataColumn) 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.Constructs a new ForeignKeyConstraint with the specified name, parent column, and child column, and adds the constraint to the collection.

public:
 virtual System::Data::Constraint ^ Add(System::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);
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 Overridable Function Add (name As String, primaryKeyColumn As DataColumn, foreignKeyColumn As DataColumn) As Constraint

Parametri

primaryKeyColumn
DataColumn DataColumn DataColumn DataColumn

Oggetto DataColumn di chiave primaria o padre.The primary key, or parent, DataColumn.

foreignKeyColumn
DataColumn DataColumn DataColumn DataColumn

Oggetto DataColumn di chiave esterna o figlio.The foreign key, or child, DataColumn.

Restituisce

Nuovo oggetto ForeignKeyConstraint.A new ForeignKeyConstraint.

Esempi

Nell'esempio seguente viene aggiunto un ForeignKeyConstraint nuovo oggetto ConstraintCollection all'oggetto DataTabledi un oggetto.The following example adds a new ForeignKeyConstraint to the ConstraintCollection of a 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' CollectionChanged evento si verifica se il vincolo viene aggiunto correttamente.The CollectionChanged event occurs if the constraint is added successfully.

Add(String, DataColumn[], Boolean) Add(String, DataColumn[], Boolean) Add(String, DataColumn[], Boolean) 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.Constructs a new UniqueConstraint with the specified name, array of DataColumn objects, and value that indicates whether the column is a primary key, and adds it to the collection.

public:
 virtual System::Data::Constraint ^ Add(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ columns, bool primaryKey);
public virtual System.Data.Constraint Add (string name, System.Data.DataColumn[] columns, bool primaryKey);
abstract member Add : string * System.Data.DataColumn[] * bool -> System.Data.Constraint
override this.Add : string * System.Data.DataColumn[] * bool -> System.Data.Constraint
Public Overridable Function Add (name As String, columns As DataColumn(), primaryKey As Boolean) As Constraint

Parametri

columns
DataColumn[]

Matrice di oggetti DataColumn a cui viene applicato il vincolo.An array of DataColumn objects to which the constraint applies.

primaryKey
Boolean Boolean Boolean Boolean

Specifica se la colonna deve essere la chiave primaria.Specifies whether the column should be the primary key. Se true, la colonna è una colonna di chiave primaria.If true, the column will be a primary key column.

Restituisce

Nuovo oggetto UniqueConstraint.A new UniqueConstraint.

Eccezioni

Il vincolo appartiene già a questo insieme.The constraint already belongs to this collection.

oppure-Or-

Il vincolo appartiene a un altro insieme.The constraint belongs to another collection.

L'insieme dispone già di un vincolo con il nome specificato.The collection already has a constraint with the specified name. Nel confronto non viene fatta distinzione tra maiuscole e minuscole.(The comparison is not case-sensitive.)

Esempi

Nell'esempio seguente viene creata una matrice DataColumn di oggetti utilizzati per creare un nuovo UniqueConstraint oggetto in un oggetto DataTablespecifico.The following example creates an array of DataColumn objects that are used to create a new UniqueConstraint in a specific 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' CollectionChanged evento si verifica se il vincolo viene aggiunto correttamente.The CollectionChanged event occurs if the constraint is added successfully.

Vedi anche

Add(String, DataColumn[], DataColumn[]) Add(String, DataColumn[], DataColumn[]) Add(String, DataColumn[], DataColumn[]) 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.Constructs a new ForeignKeyConstraint, with the specified arrays of parent columns and child columns, and adds the constraint to the collection.

public:
 virtual 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 (string name, System.Data.DataColumn[] primaryKeyColumns, System.Data.DataColumn[] foreignKeyColumns);
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 Overridable Function Add (name As String, primaryKeyColumns As DataColumn(), foreignKeyColumns As DataColumn()) As Constraint

Parametri

primaryKeyColumns
DataColumn[]

Matrice di oggetti DataColumn che rappresentano le colonne di chiave primaria o padre.An array of DataColumn objects that are the primary key, or parent, columns.

foreignKeyColumns
DataColumn[]

Matrice di oggetti DataColumn che rappresentano le colonne di chiave esterna o figlio.An array of DataColumn objects that are the foreign key, or child, columns.

Restituisce

Nuovo oggetto ForeignKeyConstraint.A new ForeignKeyConstraint.

Esempi

Nell'esempio seguente vengono create due matrici di DataColumn oggetti, quindi vengono create due ForeignKeyConstraint relazioni tra due tabelle in un set di dati.The following example creates two arrays of DataColumn objects, and then creates two ForeignKeyConstraint relationships between two tables in a dataset.

   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' CollectionChanged evento si verifica se il vincolo viene aggiunto correttamente.The CollectionChanged event occurs if the constraint is added successfully.

Si applica a