DataRelation Classe

Définition

public ref class DataRelation

[System.ComponentModel.TypeConverter(typeof(System.Data.RelationshipConverter))]
public class DataRelation

public class DataRelation

[System.ComponentModel.TypeConverter(typeof(System.Data.RelationshipConverter))]
[System.Serializable]
public class DataRelation

[<System.ComponentModel.TypeConverter(typeof(System.Data.RelationshipConverter))>]
type DataRelation = class

type DataRelation = class

[<System.ComponentModel.TypeConverter(typeof(System.Data.RelationshipConverter))>]
[<System.Serializable>]
type DataRelation = class

Public Class DataRelation

Héritage

Object

DataRelation

Attributs

TypeConverterAttribute SerializableAttribute

Exemples

L’exemple suivant crée un nouveau DataRelation et l’ajoute DataRelationCollection au 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);
}

Private Sub CreateRelation()
    ' Get the DataColumn objects from two DataTable objects 
    ' in a DataSet. Code to get the DataSet not shown here.
    Dim parentColumn As DataColumn = _
        DataSet1.Tables("Customers").Columns("CustID")
    Dim childColumn As DataColumn = DataSet1.Tables( _
        "Orders").Columns("CustID")

    ' Create DataRelation.
    Dim relCustOrder As DataRelation
    relCustOrder = New DataRelation( _
        "CustomersOrders", parentColumn, childColumn)

    ' Add the relation to the DataSet.
    DataSet1.Relations.Add(relCustOrder)
End Sub

Remarques

Un DataRelation est utilisé pour lier deux objets l’un DataTable à l’autre par le biais DataColumn d’objets. Par exemple, dans une relation Client/Commandes, la table Customers est le parent et la table Orders est l’enfant de la relation. Cela est similaire à une relation clé primaire/clé étrangère. Pour plus d’informations, consultez Navigation dans DataRelations.

Des relations sont créées entre les colonnes correspondantes dans les tables parent et enfant. Autrement dit, la DataType valeur des deux colonnes doit être identique.

Les relations peuvent également mettre en cascade diverses modifications du parent DataRow vers ses lignes enfants. Pour contrôler la façon dont les valeurs sont modifiées dans les lignes enfants, ajoutez un ForeignKeyConstraint à l’objet ConstraintCollectionDataTable . détermine ConstraintCollection l’action à entreprendre lorsqu’une valeur d’une 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’elle a été ajoutée à , DataRelationCollectionla relation est maintenue en refusant toute modification qui l’invaliderait. Entre la période où un DataRelation est créé et ajouté à , DataRelationCollectionil est possible d’apporter des modifications supplémentaires aux lignes parentes ou enfants. Une exception est générée si cela provoque une relation qui n’est plus valide.

DataRelationles objets sont contenus dans un DataRelationCollectionobjet , auquel vous pouvez accéder via la Relations propriété de , DataSetet les ChildRelations propriétés et ParentRelations de .DataTable

Constructeurs

Propriétés

Méthodes

S’applique à

Cohérence de thread

Ce type est sécurisé pour les opérations de lecture multithread. Vous devez synchroniser toutes les opérations d’écriture.

Voir aussi

• ChildRelations
• DataColumn
• DataSet
• ForeignKeyConstraint
• DataRelationCollection
• UniqueConstraint
• ParentRelations