ConstraintCollection.Add Metodo

Definizione

Spazio dei nomi:

System.Data

Assembly:

System.Data.Common.dll

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

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

• UniqueConstraint
• ForeignKeyConstraint

Add(String, DataColumn, Boolean)

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 System.Data.Constraint Add (string? name, System.Data.DataColumn column, bool primaryKey);

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

Public 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

Add(String, DataColumn, DataColumn)

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 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

Public 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 ConstraintCollectionDataTable.

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.

Add(String, DataColumn[], Boolean)

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 System.Data.Constraint Add (string? name, System.Data.DataColumn[] columns, bool primaryKey);

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

Public 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

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

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 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

Public 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.