Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

DataRelation classe

 

Date de publication : novembre 2016

Représente une relation parent/enfant entre deux DataTable objets.

Espace de noms:   System.Data
Assembly:  System.Data (dans System.Data.dll)

System.Object
  System.Data.DataRelation

public class DataRelation

NomDescription
System_CAPS_pubmethodDataRelation(String, DataColumn, DataColumn)

Initialise une nouvelle instance de la DataRelation classe utilisant le DataRelation nom et les parents et enfants DataColumn objets.

System_CAPS_pubmethodDataRelation(String, DataColumn, DataColumn, Boolean)

Initialise une nouvelle instance de la DataRelation classe en utilisant le nom spécifié, le parent et l’enfant DataColumn objets et une valeur qui indique s’il faut créer des contraintes.

System_CAPS_pubmethodDataRelation(String, DataColumn[], DataColumn[])

Initialise une nouvelle instance de la DataRelation classe utilisant le DataRelation tableaux de nom et de mise en correspondance de parents et enfants DataColumn objets.

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

Initialise une nouvelle instance de la DataRelation classe en utilisant le nom spécifié, les tableaux correspondants de parents et enfants DataColumn objets et la valeur qui indique s’il faut créer des contraintes.

System_CAPS_pubmethodDataRelation(String, String, String, String, String, String[], String[], Boolean)

Ce constructeur est fourni pour la prise en charge des temps de conception dans l’environnement Visual Studio.

System_CAPS_pubmethodDataRelation(String, String, String, String[], String[], Boolean)

Ce constructeur est fourni pour la prise en charge des temps de conception dans l’environnement Visual Studio.

NomDescription
System_CAPS_pubpropertyChildColumns

Obtient l’enfant DataColumn objets de cette relation.

System_CAPS_pubpropertyChildKeyConstraint

Obtient le ForeignKeyConstraint pour la relation.

System_CAPS_pubpropertyChildTable

Obtient la table enfant de cette relation.

System_CAPS_pubpropertyDataSet

Obtient le DataSet auquel le DataRelation appartient.

System_CAPS_pubpropertyExtendedProperties

Obtient la collection qui stocke des propriétés personnalisées.

System_CAPS_pubpropertyNested

Obtient ou définit une valeur qui indique si DataRelation sont les objets imbriqués.

System_CAPS_pubpropertyParentColumns

Obtient un tableau de DataColumn les objets qui sont les colonnes parentes de ce DataRelation.

System_CAPS_pubpropertyParentKeyConstraint

Obtient les UniqueConstraint qui garantit que les valeurs de la colonne parent d’un DataRelation sont uniques.

System_CAPS_pubpropertyParentTable

Obtient le parent DataTable de ce DataRelation.

System_CAPS_pubpropertyRelationName

Obtient ou définit le nom utilisé pour récupérer un DataRelation à partir de la DataRelationCollection.

NomDescription
System_CAPS_protmethodCheckStateForProperty()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Cette méthode prend en charge l'infrastructure .NET Framework et n'est pas destinée à être utilisée directement à partir de votre code.

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_protmethodOnPropertyChanging(PropertyChangedEventArgs)

Ce membre prend en charge l'infrastructure .NET Framework et n'est pas destiné à être utilisé directement à partir de votre code.

System_CAPS_protmethodRaisePropertyChanging(String)

Ce membre prend en charge l'infrastructure .NET Framework et n'est pas destiné à être utilisé directement à partir de votre code.

System_CAPS_pubmethodToString()

Obtient le RelationName, le cas échéant.(Remplace Object.ToString().)

Un DataRelation sert à relier deux DataTable objets entre eux via DataColumn objets. Par exemple, dans une relation Customers/Orders, la table Customers est le parent et la table Orders est l’enfant de la relation. Cela est similaire à une relation de clé étrangère/clé primaire. Pour plus d'informations, consultez Exploration des DataRelations.

Les relations sont créées entre les colonnes correspondantes dans les tables parent et enfant. Autrement dit, la DataType valeur pour les deux colonnes doivent être identiques.

Relations peuvent également répercuter en cascade différentes modifications du parent DataRow à ses lignes enfants. Pour contrôler la manière dont les valeurs sont modifiées dans les lignes enfants, ajoutez un ForeignKeyConstraint à le ConstraintCollection de la DataTable objet. Le ConstraintCollection détermine l’action à effectuer lorsqu’une valeur de la table parente est supprimée ou mise à jour.

Lorsqu’un DataRelation est créé, il vérifie d’abord que la relation peut être établie. Une fois qu’il est ajouté à la DataRelationCollection, la relation est préservée en interdisant toute modification susceptible de l’invalider. Entre la période lorsqu’un DataRelation est créé et ajouté à la DataRelationCollection, il est possible pour les autres modifications à apporter aux lignes parentes ou enfants. Une exception est générée si cela entraîne une relation qui n’est plus valide.

System_CAPS_noteRemarque

Corruption de données peut se produire si une relation bidirectionnelle est définie entre deux tables. Une relation bidirectionnelle se compose de deux DataRelation objets qui utilisent les mêmes colonnes, avec les basculement des rôles parent-enfant. Aucune exception n’est levée lorsque la DataRelation les objets sont enregistrés ; Toutefois, la corruption des données peut se produire.

DataRelation objets sont contenus dans un DataRelationCollection, auquel vous pouvez accéder via le Relations propriété de la DataSet, et ChildRelations et ParentRelations Propriétés de la DataTable.

L’exemple suivant crée un nouveau DataRelation et l’ajoute à la DataRelationCollection d’un DataSet.

private void CreateRelation() 
{
    // Get the DataColumn objects from two DataTable objects 
    // in a DataSet. Code to get the DataSet not shown here.
    DataColumn parentColumn = 
        DataSet1.Tables["Customers"].Columns["CustID"];
    DataColumn childColumn = 
        DataSet1.Tables["Orders"].Columns["CustID"];
    // Create DataRelation.
    DataRelation relCustOrder;
    relCustOrder = new DataRelation("CustomersOrders", 
        parentColumn, childColumn);
    // Add the relation to the DataSet.
    DataSet1.Relations.Add(relCustOrder);
}

.NET Framework
Disponible depuis 1.1

Ce type est sécurisé pour les opérations de lecture multithreads. Vous devez synchroniser des opérations d'écriture.

Retour au début
Afficher: