ConstraintCollection.Add Méthode

Définition

Espace de noms:: System.Data

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Ajoute un Constraint objet à la collection.

Surcharges

Nom	Description
Add(Constraint)	Ajoute l’objet spécifié Constraint à la collection.
Add(String, DataColumn, Boolean)	Construit un nouveau UniqueConstraint avec le nom spécifié, DataColumnet la valeur qui indique si la colonne est une clé primaire et l’ajoute à la collection.
Add(String, DataColumn, DataColumn)	Construit un nouveau ForeignKeyConstraint avec le nom, la colonne parente et la colonne enfant spécifiés et ajoute la contrainte à la collection.
Add(String, DataColumn[], Boolean)	Construit un nouveau UniqueConstraint avec le nom, le tableau d’objets DataColumn et la valeur spécifiés qui indique si la colonne est une clé primaire et l’ajoute à la collection.
Add(String, DataColumn[], DataColumn[])	Construit un nouveau ForeignKeyConstrainttableau, avec les tableaux spécifiés de colonnes parentes et de colonnes enfants, et ajoute la contrainte à la collection.

Add(Constraint)

Ajoute l’objet spécifié Constraint à la collection.

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)

Paramètres

constraint: Constraint

À Constraint ajouter.

Exceptions

ArgumentNullException

L’argument constraint est null.

ArgumentException

La contrainte appartient déjà à cette collection ou appartient à une autre collection.

DuplicateNameException

La collection a déjà une contrainte portant le même nom. (La comparaison n’est pas sensible à la casse.)

Exemples

L’exemple suivant ajoute un UniqueConstraint à l’objet ConstraintCollection 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

Remarques

Si la collection est correctement modifiée en ajoutant ou supprimant des contraintes, l’événement CollectionChanged se produit.

Voir aussi

S’applique à

Add(String, DataColumn, Boolean)

Construit un nouveau UniqueConstraint avec le nom spécifié, DataColumnet la valeur qui indique si la colonne est une clé primaire et l’ajoute à la collection.

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

public:
 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);

public 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

member 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

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

Paramètres

name: String

Nom du UniqueConstraint.

column: DataColumn

Auquel DataColumn la contrainte s’applique.

primaryKey: Boolean

Spécifie si la colonne doit être la clé primaire. Si true, la colonne est une colonne clé primaire.

Retours

Constraint

Une nouvelle UniqueConstraint.

Exceptions

ArgumentException

La contrainte appartient déjà à cette collection.

- Ou -

La contrainte appartient à une autre collection.

DuplicateNameException

La collection a déjà une contrainte portant le nom spécifié. (La comparaison n’est pas sensible à la casse.)

Exemples

L’exemple suivant utilise la Add méthode pour créer et ajouter un nouveau UniqueConstraint à un 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

Remarques

L’événement CollectionChanged se produit si la contrainte est ajoutée avec succès.

Voir aussi

UniqueConstraint

S’applique à

Add(String, DataColumn, DataColumn)

Construit un nouveau ForeignKeyConstraint avec le nom, la colonne parente et la colonne enfant spécifiés et ajoute la contrainte à la collection.

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

public:
 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);

public 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

member 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

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

Paramètres

name: String

Nom du ForeignKeyConstraint.

primaryKeyColumn: DataColumn

Clé primaire, ou parent, DataColumn.

foreignKeyColumn: DataColumn

Clé étrangère, ou enfant, DataColumn.

Retours

Constraint

Une nouvelle ForeignKeyConstraint.

Exemples

L’exemple suivant ajoute un nouveau ForeignKeyConstraint à l’objet 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

Remarques

L’événement CollectionChanged se produit si la contrainte est ajoutée avec succès.

S’applique à

Add(String, DataColumn[], Boolean)

Construit un nouveau UniqueConstraint avec le nom, le tableau d’objets DataColumn et la valeur spécifiés qui indique si la colonne est une clé primaire et l’ajoute à la collection.

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

public:
 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);

public 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

member 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

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

Paramètres

name: String

Nom du UniqueConstraint.

columns: DataColumn[]

Tableau d’objets DataColumn auxquels la contrainte s’applique.

primaryKey: Boolean

Spécifie si la colonne doit être la clé primaire. Si true, la colonne est une colonne clé primaire.

Retours

Constraint

Une nouvelle UniqueConstraint.

Exceptions

ArgumentException

La contrainte appartient déjà à cette collection.

- Ou -

La contrainte appartient à une autre collection.

DuplicateNameException

La collection a déjà une contrainte portant le nom spécifié. (La comparaison n’est pas sensible à la casse.)

Exemples

L’exemple suivant crée un tableau d’objets DataColumn utilisés pour créer un nouveau UniqueConstraint tableau dans un objet spécifique 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

Remarques

L’événement CollectionChanged se produit si la contrainte est ajoutée avec succès.

Voir aussi

UniqueConstraint

S’applique à

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

Construit un nouveau ForeignKeyConstrainttableau, avec les tableaux spécifiés de colonnes parentes et de colonnes enfants, et ajoute la contrainte à la collection.

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(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);

public 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

member 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

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

Paramètres

name: String

Nom du ForeignKeyConstraint.

primaryKeyColumns: DataColumn[]

Tableau d’objets DataColumn qui sont la clé primaire, ou les colonnes parentes.

foreignKeyColumns: DataColumn[]

Tableau d’objets DataColumn qui sont la clé étrangère ou les colonnes enfants.

Retours

Constraint

Une nouvelle ForeignKeyConstraint.

Exemples

L’exemple suivant crée deux tableaux d’objets, puis crée deux ForeignKeyConstraint relations entre deux tables dans un jeu de DataColumn données.

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

Remarques

L’événement CollectionChanged se produit si la contrainte est ajoutée avec succès.

S’applique à

Commentaires

Cette page a-t-elle été utile ?