DataRelationCollection.Add Méthode

Référence

Définition

Espace de noms:: System.Data

Assembly:: System.Data.Common.dll

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 objet DataRelation à DataRelationCollection.

Surcharges

Add(DataRelation)	Ajoute un objet DataRelation à DataRelationCollection.
Add(DataColumn, DataColumn)	Crée un DataRelation avec une colonne parent et enfant spécifiée, puis l'ajoute à la collection.
Add(DataColumn[], DataColumn[])	Crée un DataRelation avec les colonnes parentes et enfants spécifiées, puis l'ajoute à la collection.
Add(String, DataColumn, DataColumn)	Crée un DataRelation avec le nom spécifié ainsi que les colonnes parentes et enfants, puis l'ajoute à la collection.
Add(String, DataColumn[], DataColumn[])	Crée un DataRelation avec le nom spécifié, ainsi que les tableaux de colonnes parentes et enfants, puis l'ajoute à la collection.
Add(String, DataColumn, DataColumn, Boolean)	Crée un DataRelation avec le nom spécifié, les colonnes parentes et enfants, avec des contraintes facultatives selon la valeur du paramètre `createConstraints`, puis l'ajoute à la collection.
Add(String, DataColumn[], DataColumn[], Boolean)	Crée un DataRelation avec le nom spécifié, les tableaux de colonnes parentes et enfants, ainsi qu'une valeur spécifiant si une contrainte doit être créée, puis l'ajoute à la collection.

Add(DataRelation)

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

Ajoute un objet DataRelation à DataRelationCollection.

public:
 void Add(System::Data::DataRelation ^ relation);

public void Add (System.Data.DataRelation relation);

member this.Add : System.Data.DataRelation -> unit

Public Sub Add (relation As DataRelation)

Paramètres

relation: DataRelation

Objet DataRelation à ajouter à la collection.

Exceptions

ArgumentNullException

Le paramètre relation est une valeur null.

ArgumentException

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

DuplicateNameException

La collection possède déjà une relation portant le nom spécifié. (La comparaison ne respecte pas la casse.)

InvalidConstraintException

La relation est dans un état non valide depuis sa création.

Remarques

Si la relation est correctement ajoutée à la collection, l’événement CollectionChanged se produit.

Lorsqu’un DataRelation objet est ajouté à la collection, ForeignKeyConstraint et UniqueConstraint les objets sont créés par défaut s’ils n’existent pas déjà.

Voir aussi

S’applique à

Add(DataColumn, DataColumn)

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

Crée un DataRelation avec une colonne parent et enfant spécifiée, puis l'ajoute à la collection.

public:
 virtual System::Data::DataRelation ^ Add(System::Data::DataColumn ^ parentColumn, System::Data::DataColumn ^ childColumn);

public virtual System.Data.DataRelation Add (System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn);

abstract member Add : System.Data.DataColumn * System.Data.DataColumn -> System.Data.DataRelation
override this.Add : System.Data.DataColumn * System.Data.DataColumn -> System.Data.DataRelation

Public Overridable Function Add (parentColumn As DataColumn, childColumn As DataColumn) As DataRelation

Paramètres

parentColumn: DataColumn

Colonne parente de la relation.

childColumn: DataColumn

Colonne enfant de la relation.

Retours

DataRelation

Relation créée.

Remarques

Lorsqu’un DataRelation objet est ajouté à la collection, ForeignKeyConstraint et UniqueConstraint les objets sont créés par défaut s’ils n’existent pas déjà.

Voir aussi

S’applique à

Add(DataColumn[], DataColumn[])

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

Crée un DataRelation avec les colonnes parentes et enfants spécifiées, puis l'ajoute à la collection.

public:
 virtual System::Data::DataRelation ^ Add(cli::array <System::Data::DataColumn ^> ^ parentColumns, cli::array <System::Data::DataColumn ^> ^ childColumns);

public virtual System.Data.DataRelation Add (System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns);

abstract member Add : System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.DataRelation
override this.Add : System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.DataRelation

Public Overridable Function Add (parentColumns As DataColumn(), childColumns As DataColumn()) As DataRelation

Paramètres

parentColumns: DataColumn[]

Colonnes parentes de la relation.

childColumns: DataColumn[]

Colonnes enfants de la relation.

Retours

DataRelation

Relation créée.

Exceptions

ArgumentNullException

L'argument relation est une valeur null.

ArgumentException

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

DuplicateNameException

La collection possède déjà une relation portant le même nom. (La comparaison ne respecte pas la casse.)

InvalidConstraintException

La relation est dans un état non valide depuis sa création.

Remarques

Lorsqu’un DataRelation objet est ajouté à la collection, ForeignKeyConstraint et UniqueConstraint les objets sont créés par défaut s’ils n’existent pas déjà.

Voir aussi

S’applique à

Add(String, DataColumn, DataColumn)

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

Crée un DataRelation avec le nom spécifié ainsi que les colonnes parentes et enfants, puis l'ajoute à la collection.

public:
 virtual System::Data::DataRelation ^ Add(System::String ^ name, System::Data::DataColumn ^ parentColumn, System::Data::DataColumn ^ childColumn);

public virtual System.Data.DataRelation Add (string? name, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn);

public virtual System.Data.DataRelation Add (string name, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn);

abstract member Add : string * System.Data.DataColumn * System.Data.DataColumn -> System.Data.DataRelation
override this.Add : string * System.Data.DataColumn * System.Data.DataColumn -> System.Data.DataRelation

Public Overridable Function Add (name As String, parentColumn As DataColumn, childColumn As DataColumn) As DataRelation

Paramètres

name: String

Nom de la relation.

parentColumn: DataColumn

Colonne parente de la relation.

childColumn: DataColumn

Colonne enfant de la relation.

Retours

DataRelation

Relation créée.

Remarques

Lorsqu’un DataRelation objet est ajouté à la collection, ForeignKeyConstraint et UniqueConstraint les objets sont créés par défaut s’ils n’existent pas déjà.

Voir aussi

S’applique à

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

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

Crée un DataRelation avec le nom spécifié, ainsi que les tableaux de colonnes parentes et enfants, puis l'ajoute à la collection.

public:
 virtual System::Data::DataRelation ^ Add(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ parentColumns, cli::array <System::Data::DataColumn ^> ^ childColumns);

public virtual System.Data.DataRelation Add (string? name, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns);

public virtual System.Data.DataRelation Add (string name, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns);

abstract member Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.DataRelation
override this.Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.DataRelation

Public Overridable Function Add (name As String, parentColumns As DataColumn(), childColumns As DataColumn()) As DataRelation

Paramètres

name: String

Nom du DataRelation à créer.

parentColumns: DataColumn[]

Tableau d'objets DataColumn parents.

childColumns: DataColumn[]

Tableau d'objets DataColumn enfants.

Retours

DataRelation

Élément DataRelation créé.

Exceptions

ArgumentNullException

Le nom de la relation est une valeur null.

ArgumentException

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

DuplicateNameException

La collection possède déjà une relation portant le même nom. (La comparaison ne respecte pas la casse.)

InvalidConstraintException

La relation est dans un état non valide depuis sa création.

Exemples

private void AddRelation()
{
    DataTable table = new DataTable();
    DataColumn column1 = table.Columns.Add("Column1");
    DataColumn column2 = table.Columns.Add("Column2");
    table.ChildRelations.Add("New Relation", column1, column2);
}

Private Sub AddRelation()
    Dim table As New DataTable()
    Dim column1 As DataColumn = table.Columns.Add("Column1")
    Dim column2 As DataColumn = table.Columns.Add("Column2")
    table.ChildRelations.Add("New Relation", column1, column2)
End Sub

Remarques

Si la relation est correctement ajoutée à la collection, l’événement CollectionChanged se produit.

Lorsqu’un DataRelation objet est ajouté à la collection, ForeignKeyConstraint et UniqueConstraint les objets sont créés par défaut s’ils n’existent pas déjà.

Voir aussi

S’applique à

Add(String, DataColumn, DataColumn, Boolean)

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

Crée un DataRelation avec le nom spécifié, les colonnes parentes et enfants, avec des contraintes facultatives selon la valeur du paramètre createConstraints, puis l'ajoute à la collection.

public:
 virtual System::Data::DataRelation ^ Add(System::String ^ name, System::Data::DataColumn ^ parentColumn, System::Data::DataColumn ^ childColumn, bool createConstraints);

public virtual System.Data.DataRelation Add (string? name, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn, bool createConstraints);

public virtual System.Data.DataRelation Add (string name, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn, bool createConstraints);

abstract member Add : string * System.Data.DataColumn * System.Data.DataColumn * bool -> System.Data.DataRelation
override this.Add : string * System.Data.DataColumn * System.Data.DataColumn * bool -> System.Data.DataRelation

Public Overridable Function Add (name As String, parentColumn As DataColumn, childColumn As DataColumn, createConstraints As Boolean) As DataRelation

Paramètres

name: String

Nom de la relation.

parentColumn: DataColumn

Colonne parente de la relation.

childColumn: DataColumn

Colonne enfant de la relation.

createConstraints: Boolean

true pour créer des contraintes ; sinon, false. (La valeur par défaut est true.)

Retours

DataRelation

Relation créée.

Remarques

Lorsqu’un DataRelation objet est ajouté à la collection, ForeignKeyConstraint et UniqueConstraint les objets sont créés par défaut s’ils n’existent pas déjà. Pour éviter cela, vous pouvez définir sur createConstraints false.

Voir aussi

S’applique à

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

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

Crée un DataRelation avec le nom spécifié, les tableaux de colonnes parentes et enfants, ainsi qu'une valeur spécifiant si une contrainte doit être créée, puis l'ajoute à la collection.

public:
 virtual System::Data::DataRelation ^ Add(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ parentColumns, cli::array <System::Data::DataColumn ^> ^ childColumns, bool createConstraints);

public virtual System.Data.DataRelation Add (string? name, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns, bool createConstraints);

public virtual System.Data.DataRelation Add (string name, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns, bool createConstraints);

abstract member Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] * bool -> System.Data.DataRelation
override this.Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] * bool -> System.Data.DataRelation

Public Overridable Function Add (name As String, parentColumns As DataColumn(), childColumns As DataColumn(), createConstraints As Boolean) As DataRelation

Paramètres

name: String

Nom du DataRelation à créer.

parentColumns: DataColumn[]

Tableau d'objets DataColumn parents.

childColumns: DataColumn[]

Tableau d'objets DataColumn enfants.

createConstraints: Boolean

true pour créer une contrainte ; sinon, false.

Retours

DataRelation

Relation créée.

Exceptions

ArgumentNullException

Le nom de la relation est une valeur null.

ArgumentException

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

DuplicateNameException

La collection possède déjà une relation portant le même nom. (La comparaison ne respecte pas la casse.)

InvalidConstraintException

La relation est dans un état non valide depuis sa création.

Remarques

Lorsqu’un DataRelation objet est ajouté à la collection, ForeignKeyConstraint et UniqueConstraint les objets sont créés par défaut s’ils n’existent pas déjà.

Voir aussi

S’applique à

DataRelationCollection.Add Méthode

Définition

Surcharges

Add(DataRelation)

Paramètres

Exceptions

Remarques

Voir aussi

S’applique à

Add(DataColumn, DataColumn)

Paramètres

Retours

Remarques

Voir aussi

S’applique à

Add(DataColumn[], DataColumn[])

Paramètres

Retours

Exceptions

Remarques

Voir aussi

S’applique à

Add(String, DataColumn, DataColumn)

Paramètres

Retours

Remarques

Voir aussi

S’applique à

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

Paramètres

Retours

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

Add(String, DataColumn, DataColumn, Boolean)

Paramètres

Retours

Remarques

Voir aussi

S’applique à

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

Paramètres

Retours

Exceptions

Remarques

Voir aussi

S’applique à

Commentaires

Ressources supplémentaires