DataRelationCollection.Add DataRelationCollection.Add DataRelationCollection.Add DataRelationCollection.Add Method

Définition

Surcharges

Add(DataRelation) Add(DataRelation) Add(DataRelation) Add(DataRelation)

Ajoute un objet DataRelation à DataRelationCollection.Adds a DataRelation to the DataRelationCollection.

Add(DataColumn, DataColumn) Add(DataColumn, DataColumn) Add(DataColumn, DataColumn) Add(DataColumn, DataColumn)

Crée un DataRelation avec une colonne parent et enfant spécifiée, puis l'ajoute à la collection.Creates a DataRelation with a specified parent and child column, and adds it to the collection.

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

Crée un DataRelation avec les colonnes parentes et enfants spécifiées, puis l'ajoute à la collection.Creates a DataRelation with the specified parent and child columns, and adds it to the collection.

Add(String, DataColumn, DataColumn) Add(String, DataColumn, DataColumn) Add(String, DataColumn, DataColumn) 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.Creates a DataRelation with the specified name, and parent and child columns, and adds it to the collection.

Add(String, DataColumn[], DataColumn[]) Add(String, DataColumn[], DataColumn[]) Add(String, DataColumn[], DataColumn[]) 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.Creates a DataRelation with the specified name and arrays of parent and child columns, and adds it to the collection.

Add(String, DataColumn, DataColumn, Boolean) Add(String, DataColumn, DataColumn, Boolean) Add(String, DataColumn, DataColumn, Boolean) 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.Creates a DataRelation with the specified name, parent and child columns, with optional constraints according to the value of the createConstraints parameter, and adds it to the collection.

Add(String, DataColumn[], DataColumn[], Boolean) Add(String, DataColumn[], DataColumn[], Boolean) Add(String, DataColumn[], DataColumn[], Boolean) 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.Creates a DataRelation with the specified name, arrays of parent and child columns, and value specifying whether to create a constraint, and adds it to the collection.

Add(DataRelation) Add(DataRelation) Add(DataRelation) Add(DataRelation)

Ajoute un objet DataRelation à DataRelationCollection.Adds a DataRelation to the 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 DataRelation DataRelation DataRelation

Objet DataRelation à ajouter à la collection.The DataRelation to add to the collection.

Exceptions

Le paramètre relation est une valeur null.The relation parameter is a null value.

La relation appartient déjà à cette collection ou à une autre collection.The relation already belongs to this collection, or it belongs to another collection.

La collection possède déjà une relation portant le nom spécifié.The collection already has a relation with the specified name. (La comparaison ne respecte pas la casse.)(The comparison is not case sensitive.)

La relation est dans un état non valide depuis sa création.The relation has entered an invalid state since it was created.

Remarques

Si la relation est correctement ajoutée à la collection, l' CollectionChanged événement se produit.If the relation is successfully added to the collection, the CollectionChanged event occurs.

Lorsqu’un DataRelation objet est ajouté à la collection UniqueConstraint , ForeignKeyConstraint les objets sont créés par défaut s’ils n’existent pas déjà.When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist.

Voir aussi

Add(DataColumn, DataColumn) Add(DataColumn, DataColumn) Add(DataColumn, DataColumn) Add(DataColumn, DataColumn)

Crée un DataRelation avec une colonne parent et enfant spécifiée, puis l'ajoute à la collection.Creates a DataRelation with a specified parent and child column, and adds it to the 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 DataColumn DataColumn DataColumn

Colonne parente de la relation.The parent column of the relation.

childColumn
DataColumn DataColumn DataColumn DataColumn

Colonne enfant de la relation.The child column of the relation.

Retours

Relation créée.The created relation.

Remarques

Lorsqu’un DataRelation objet est ajouté à la collection UniqueConstraint , ForeignKeyConstraint les objets sont créés par défaut s’ils n’existent pas déjà.When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist.

Voir aussi

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

Crée un DataRelation avec les colonnes parentes et enfants spécifiées, puis l'ajoute à la collection.Creates a DataRelation with the specified parent and child columns, and adds it to the 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.The parent columns of the relation.

childColumns
DataColumn[]

Colonnes enfants de la relation.The child columns of the relation.

Retours

Relation créée.The created relation.

Exceptions

L'argument relation est une valeur null.The relation argument is a null value.

La relation appartient déjà à cette collection ou à une autre collection.The relation already belongs to this collection, or it belongs to another collection.

La collection possède déjà une relation portant le même nom.The collection already has a relation with the same name. (La comparaison ne respecte pas la casse.)(The comparison is not case sensitive.)

La relation est dans un état non valide depuis sa création.The relation has entered an invalid state since it was created.

Remarques

Lorsqu’un DataRelation objet est ajouté à la collection UniqueConstraint , ForeignKeyConstraint les objets sont créés par défaut s’ils n’existent pas déjà.When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist.

Voir aussi

Add(String, DataColumn, DataColumn) Add(String, DataColumn, DataColumn) Add(String, DataColumn, DataColumn) 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.Creates a DataRelation with the specified name, and parent and child columns, and adds it to the 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);
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 String String String

Nom de la relation.The name of the relation.

parentColumn
DataColumn DataColumn DataColumn DataColumn

Colonne parente de la relation.The parent column of the relation.

childColumn
DataColumn DataColumn DataColumn DataColumn

Colonne enfant de la relation.The child column of the relation.

Retours

Relation créée.The created relation.

Remarques

Lorsqu’un DataRelation objet est ajouté à la collection UniqueConstraint , ForeignKeyConstraint les objets sont créés par défaut s’ils n’existent pas déjà.When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist.

Voir aussi

Add(String, DataColumn[], DataColumn[]) Add(String, DataColumn[], DataColumn[]) Add(String, DataColumn[], DataColumn[]) 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.Creates a DataRelation with the specified name and arrays of parent and child columns, and adds it to the 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);
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 String String String

Nom du DataRelation à créer.The name of the DataRelation to create.

parentColumns
DataColumn[]

Tableau d'objets DataColumn parents.An array of parent DataColumn objects.

childColumns
DataColumn[]

Tableau d'objets DataColumn enfants.An array of child DataColumn objects.

Retours

Élément DataRelation créé.The created DataRelation.

Exceptions

Le nom de la relation est une valeur null.The relation name is a null value.

La relation appartient déjà à cette collection ou à une autre collection.The relation already belongs to this collection, or it belongs to another collection.

La collection possède déjà une relation portant le même nom.The collection already has a relation with the same name. (La comparaison ne respecte pas la casse.)(The comparison is not case sensitive.)

La relation est dans un état non valide depuis sa création.The relation has entered an invalid state since it was created.

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' CollectionChanged événement se produit.If the relation is successfully added to the collection, the CollectionChanged event occurs.

Lorsqu’un DataRelation objet est ajouté à la collection UniqueConstraint , ForeignKeyConstraint les objets sont créés par défaut s’ils n’existent pas déjà.When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist.

Voir aussi

Add(String, DataColumn, DataColumn, Boolean) Add(String, DataColumn, DataColumn, Boolean) Add(String, DataColumn, DataColumn, Boolean) 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.Creates a DataRelation with the specified name, parent and child columns, with optional constraints according to the value of the createConstraints parameter, and adds it to the 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);
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 String String String

Nom de la relation.The name of the relation.

parentColumn
DataColumn DataColumn DataColumn DataColumn

Colonne parente de la relation.The parent column of the relation.

childColumn
DataColumn DataColumn DataColumn DataColumn

Colonne enfant de la relation.The child column of the relation.

createConstraints
Boolean Boolean Boolean Boolean

true pour créer des contraintes ; sinon, false.true to create constraints; otherwise false. (La valeur par défaut est true.)(The default is true).

Retours

Relation créée.The created relation.

Remarques

Lorsqu’un DataRelation objet est ajouté à la collection UniqueConstraint , ForeignKeyConstraint les objets sont créés par défaut s’ils n’existent pas déjà.When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist. Pour éviter cela, vous pouvez affecter createConstraints à la valeur false.To prevent this, you can set createConstraints to false.

Voir aussi

Add(String, DataColumn[], DataColumn[], Boolean) Add(String, DataColumn[], DataColumn[], Boolean) Add(String, DataColumn[], DataColumn[], Boolean) 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.Creates a DataRelation with the specified name, arrays of parent and child columns, and value specifying whether to create a constraint, and adds it to the 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);
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 String String String

Nom du DataRelation à créer.The name of the DataRelation to create.

parentColumns
DataColumn[]

Tableau d'objets DataColumn parents.An array of parent DataColumn objects.

childColumns
DataColumn[]

Tableau d'objets DataColumn enfants.An array of child DataColumn objects.

createConstraints
Boolean Boolean Boolean Boolean

true pour créer une contrainte ; sinon, false.true to create a constraint; otherwise false.

Retours

Relation créée.The created relation.

Exceptions

Le nom de la relation est une valeur null.The relation name is a null value.

La relation appartient déjà à cette collection ou à une autre collection.The relation already belongs to this collection, or it belongs to another collection.

La collection possède déjà une relation portant le même nom.The collection already has a relation with the same name. (La comparaison ne respecte pas la casse.)(The comparison is not case sensitive.)

La relation est dans un état non valide depuis sa création.The relation has entered an invalid state since it was created.

Remarques

Lorsqu’un DataRelation objet est ajouté à la collection UniqueConstraint , ForeignKeyConstraint les objets sont créés par défaut s’ils n’existent pas déjà.When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist.

Voir aussi

S’applique à