Partager via

Ajout de DataRelations

Dans un DataSet avec plusieurs DataTable objets, vous pouvez utiliser DataRelation des objets pour lier une table à une autre, pour parcourir les tables et retourner des lignes enfants ou parentes à partir d’une table associée.

Les arguments requis pour créer une DataRelation sont un nom pour la création de DataRelation et un tableau d’une ou DataColumn plusieurs références aux colonnes qui servent de colonnes parentes et enfants dans la relation. Une fois que vous avez créé un DataRelation, vous pouvez l’utiliser pour naviguer entre les tables et récupérer des valeurs.

Ajout d’une dataRelation à un DataSet ajout, par défaut, à UniqueConstraint la table parente et ForeignKeyConstraint à la table enfant. Pour plus d’informations sur ces contraintes par défaut, consultez Contraintes DataTable.

L’exemple de code suivant crée une DataRelation à l’aide de deux DataTable objets dans un DataSet. Chacun DataTable contient une colonne nommée CustID, qui sert de lien entre les deux DataTable objets. L’exemple ajoute une seule DataRelation à la collection Relations de l’objet DataSet. Le premier argument de l’exemple spécifie le nom de dataRelation en cours de création. Le deuxième argument définit le DataColumn parent et le troisième argument définit le DataColumn enfant.

customerOrders.Relations.Add("CustOrders", _  
  customerOrders.Tables("Customers").Columns("CustID"), _  
  customerOrders.Tables("Orders").Columns("CustID"))  

customerOrders.Relations.Add("CustOrders",  
  customerOrders.Tables["Customers"].Columns["CustID"],  
  customerOrders.Tables["Orders"].Columns["CustID"]);

Une dataRelation a également une propriété imbriquée qui, lorsqu’elle est définie sur true, entraîne l’imbrication des lignes de la table enfant dans la ligne associée de la table parente lorsqu’elles sont écrites en tant qu’éléments XML à l’aide WriteXml de . Pour plus d’informations, consultez Utilisation de XML dans un DataSet.

Voir aussi