DataRelationCollection.Add Méthode

Définition

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)

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

Le paramètre relation est une valeur null.

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

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

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 et UniqueConstraint ForeignKeyConstraint que les objets sont créés par défaut s’ils n’existent pas déjà.

Voir aussi

S’applique à

Add(DataColumn, DataColumn)

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 et UniqueConstraint ForeignKeyConstraint que les objets sont créés par défaut s’ils n’existent pas déjà.

Voir aussi

S’applique à

Add(DataColumn[], DataColumn[])

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

L'argument relation est une valeur null.

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

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

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

Remarques

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

Voir aussi

S’applique à

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.

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 et UniqueConstraint ForeignKeyConstraint que les objets sont créés par défaut s’ils n’existent pas déjà.

Voir aussi

S’applique à

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.

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

Le nom de la relation est une valeur null.

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

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

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 et UniqueConstraint ForeignKeyConstraint que les objets sont créés par défaut s’ils n’existent pas déjà.

Voir aussi

S’applique à

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.

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 et UniqueConstraint ForeignKeyConstraint que les objets sont créés par défaut s’ils n’existent pas déjà. Pour éviter cela, vous pouvez définir createConstraints la valeur false.

Voir aussi

S’applique à

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.

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

Le nom de la relation est une valeur null.

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

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

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

Remarques

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

Voir aussi

S’applique à