Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Dans un objet DataSet contenant plusieurs objets DataTable, vous pouvez utiliser des objets DataRelation pour associer une table à une autre, pour vous déplacer dans les tables et pour retourner les lignes enfants ou parentes d'une table associée.
Les arguments requis pour créer un DataRelation sont un nom pour la DataRelation, et un tableau d'une ou plusieurs DataColumn références aux colonnes qui servent de colonne parente et enfant 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’un DataRelation à un DataSet ajoute, par défaut, un UniqueConstraint à la table parente et un ForeignKeyConstraint à la table enfant. Pour plus d’informations sur ces contraintes par défaut, consultez Contraintes DataTable.
L’exemple de code suivant crée un DataRelation objet à 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 un seul DataRelation à la Relations collection du DataSet. Le premier argument de l’exemple spécifie le nom de l’objet DataRelation créé. Le deuxième argument définit le parent DataColumn 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"]);
Un DataRelation a également une propriété Nested 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 de WriteXml. Pour plus d’informations, consultez Utilisation de XML dans un DataSet.