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

Surcharges

Nom	Description
Add(DataRelation)	Ajoute un DataRelation à l’objet DataRelationCollection.
Add(DataColumn, DataColumn)	Crée une DataRelation avec une colonne parente et enfant spécifiée et l’ajoute à la collection.
Add(DataColumn[], DataColumn[])	Crée un DataRelation avec les colonnes parent et enfant spécifiées et l’ajoute à la collection.
Add(String, DataColumn, DataColumn)	Crée un DataRelation avec le nom spécifié, ainsi que les colonnes parent et enfant, et l’ajoute à la collection.
Add(String, DataColumn[], DataColumn[])	Crée un DataRelation avec le nom et les tableaux spécifiés des colonnes parent et enfant, puis l’ajoute à la collection.
Add(String, DataColumn, DataColumn, Boolean)	Crée un DataRelation avec le nom, le parent et les colonnes enfants spécifiés, avec des contraintes facultatives en fonction de la valeur du paramètre `createConstraints` et l’ajoute à la collection.
Add(String, DataColumn[], DataColumn[], Boolean)	Crée un DataRelation avec le nom, les tableaux de colonnes parent et enfant spécifiés et la valeur spécifiant s’il faut créer une contrainte et l’ajoute à la collection.

Add(DataRelation)

Ajoute un DataRelation à l’objet 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 ajouter à la collection.

Exceptions

ArgumentNullException

Le relation paramètre est une valeur Null.

ArgumentException

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

DuplicateNameException

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

InvalidConstraintException

La relation a entré 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

Ajout de DataRelations
navigation dans les DataRelations

S’applique à

Add(DataColumn, DataColumn)

Crée une DataRelation avec une colonne parente et enfant spécifiée et 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

Ajout de DataRelations
navigation dans les DataRelations

S’applique à

Add(DataColumn[], DataColumn[])

Crée un DataRelation avec les colonnes parent et enfant spécifiées et 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

ArgumentException

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

DuplicateNameException

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

InvalidConstraintException

La relation a entré 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

Ajout de DataRelations
navigation dans les DataRelations

S’applique à

Add(String, DataColumn, DataColumn)

Crée un DataRelation avec le nom spécifié, ainsi que les colonnes parent et enfant, et 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);

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

Ajout de DataRelations
navigation dans les DataRelations

S’applique à

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

Crée un DataRelation avec le nom et les tableaux spécifiés des colonnes parent et enfant, 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);

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 de la DataRelation création.

parentColumns: DataColumn[]

Tableau d’objets parents DataColumn .

childColumns: DataColumn[]

Tableau d’objets enfants DataColumn .

Retours

DataRelation

Le fichier créé DataRelation.

Exceptions

ArgumentNullException

Le nom de la relation est une valeur Null.

ArgumentException

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

DuplicateNameException

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

InvalidConstraintException

La relation a entré 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

Ajout de DataRelations
navigation dans les DataRelations

S’applique à

Add(String, DataColumn, DataColumn, Boolean)

Crée un DataRelation avec le nom, le parent et les colonnes enfants spécifiés, avec des contraintes facultatives en fonction de la valeur du paramètre createConstraints et 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);

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

Ajout de DataRelations
navigation dans les DataRelations

S’applique à

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

Crée un DataRelation avec le nom, les tableaux de colonnes parent et enfant spécifiés et la valeur spécifiant s’il faut créer une contrainte et 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);

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 de la DataRelation création.

parentColumns: DataColumn[]

Tableau d’objets parents DataColumn .

childColumns: DataColumn[]

Tableau d’objets enfants DataColumn .

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 elle appartient à une autre collection.

DuplicateNameException

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

InvalidConstraintException

La relation a entré 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

Ajout de DataRelations
navigation dans les DataRelations

S’applique à

Commentaires

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