Condividi tramite


ConstraintCollection.Add Metodo

Definizione

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

L'argomento constraint è Null.

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

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

Nuovo oggetto UniqueConstraint.

Eccezioni

Il vincolo appartiene già a questo insieme.

Oppure

Il vincolo appartiene a un altro insieme.

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

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

primaryKeyColumn
DataColumn

Oggetto DataColumn di chiave primaria o padre.

foreignKeyColumn
DataColumn

Oggetto DataColumn di chiave esterna o figlio.

Restituisce

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.

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

Nuovo oggetto UniqueConstraint.

Eccezioni

Il vincolo appartiene già a questo insieme.

Oppure

Il vincolo appartiene a un altro insieme.

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

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

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

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