ConstraintCollection.Add Metodo

Definizione

Spazio dei nomi:: System.Data

Assembly:: netstandard.dll, System.Data.Common.dll

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 Constraint oggetto all'insieme.

Overload

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

Add(Constraint)

Origine:: ConstraintCollection.cs

Origine:: ConstraintCollection.cs

Origine:: ConstraintCollection.cs

Origine:: ConstraintCollection.cs

Origine:: ConstraintCollection.cs

Aggiunge l'oggetto specificato Constraint all'insieme.

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à a questa raccolta o appartiene a un'altra raccolta.

DuplicateNameException

L'insieme ha già un vincolo con lo stesso nome. Il confronto non fa 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 correttamente aggiungendo o rimuovendo vincoli, si verifica l'evento CollectionChanged .

Vedi anche

Si applica a

Add(String, DataColumn, Boolean)

Origine:: ConstraintCollection.cs

Origine:: ConstraintCollection.cs

Origine:: ConstraintCollection.cs

Origine:: ConstraintCollection.cs

Origine:: ConstraintCollection.cs

Costruisce un nuovo UniqueConstraint oggetto con il nome specificato, DataColumn, e il valore che indica se la colonna è una chiave primaria e la aggiunge alla raccolta.

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 del UniqueConstraint.

column: DataColumn

Oggetto DataColumn a cui si applica il vincolo.

primaryKey: Boolean

Specifica se la colonna deve essere la chiave primaria. Se true, la colonna sarà una colonna chiave primaria.

Valori restituiti

Constraint

Nuovo UniqueConstraint.

Eccezioni

ArgumentException

Il vincolo appartiene già a questa raccolta.

-Or-

Il vincolo appartiene a un'altra raccolta.

DuplicateNameException

La raccolta ha già un vincolo con il nome specificato. Il confronto non fa 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)

Origine:: ConstraintCollection.cs

Origine:: ConstraintCollection.cs

Origine:: ConstraintCollection.cs

Origine:: ConstraintCollection.cs

Origine:: ConstraintCollection.cs

Costruisce un nuovo ForeignKeyConstraint oggetto con il nome, la colonna padre e la colonna figlio specificati e aggiunge il vincolo alla raccolta.

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 del ForeignKeyConstraint.

primaryKeyColumn: DataColumn

Chiave primaria, o padre, DataColumn.

foreignKeyColumn: DataColumn

Chiave esterna, o figlio, DataColumn.

Valori restituiti

Constraint

Nuovo ForeignKeyConstraint.

Esempio

Nell'esempio seguente viene aggiunto un nuovo ForeignKeyConstraint oggetto a ConstraintCollection di un oggetto 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)

Origine:: ConstraintCollection.cs

Origine:: ConstraintCollection.cs

Origine:: ConstraintCollection.cs

Origine:: ConstraintCollection.cs

Origine:: ConstraintCollection.cs

Costruisce un nuovo UniqueConstraint oggetto con il nome, la matrice di DataColumn oggetti e il valore specificati che indica se la colonna è una chiave primaria e la aggiunge 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 del UniqueConstraint.

columns: DataColumn[]

Matrice di DataColumn oggetti a cui si applica il vincolo.

primaryKey: Boolean

Specifica se la colonna deve essere la chiave primaria. Se true, la colonna sarà una colonna chiave primaria.

Valori restituiti

Constraint

Nuovo UniqueConstraint.

Eccezioni

ArgumentException

Il vincolo appartiene già a questa raccolta.

-Or-

Il vincolo appartiene a un'altra raccolta.

DuplicateNameException

La raccolta ha già un vincolo con il nome specificato. Il confronto non fa 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[])

Origine:: ConstraintCollection.cs

Origine:: ConstraintCollection.cs

Origine:: ConstraintCollection.cs

Origine:: ConstraintCollection.cs

Origine:: ConstraintCollection.cs

Costruisce un nuovo ForeignKeyConstraintoggetto , con le matrici specificate di colonne padre e colonne figlio e aggiunge il vincolo alla raccolta.

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 del ForeignKeyConstraint.

primaryKeyColumns: DataColumn[]

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

foreignKeyColumns: DataColumn[]

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

Valori restituiti

Constraint

Nuovo ForeignKeyConstraint.

Esempio

Nell'esempio seguente vengono create due matrici di oggetti e quindi vengono create due DataColumn relazioni tra due tabelle in un set di ForeignKeyConstraint 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

Commenti e suggerimenti

Questa pagina è stata utile?