DataRelation Classe

Definizione

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

Ereditarietà

Object

DataRelation

Attributi

TypeConverterAttribute SerializableAttribute

Esempio

Nell'esempio seguente viene creato un nuovo DataRelation oggetto e viene aggiunto all'oggetto DataRelationCollection di un oggetto 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

Commenti

Un DataRelation oggetto viene utilizzato per correlare due DataTable oggetti tra loro tramite DataColumn oggetti . Ad esempio, in una relazione Customer/Orders, la tabella Customers è l'elemento padre e la tabella Orders è l'elemento figlio della relazione. È simile a una relazione chiave primaria/chiave esterna. Per altre informazioni, vedere Esplorazione di dataRelations.

Le relazioni vengono create tra colonne corrispondenti nelle tabelle padre e figlio. Ovvero, il DataType valore per entrambe le colonne deve essere identico.

Le relazioni possono anche propagare varie modifiche dall'elemento padre DataRow alle righe figlio. Per controllare la modifica dei valori nelle righe figlio, aggiungere un ForeignKeyConstraint oggetto all'oggetto ConstraintCollection dell'oggetto DataTable . Determina ConstraintCollection l'azione da eseguire quando un valore in una tabella padre viene eliminato o aggiornato.

Quando un oggetto DataRelation viene creato, verifica innanzitutto che la relazione possa essere stabilita. Dopo l'aggiunta DataRelationCollectiona , la relazione viene mantenuta non consentendo le modifiche che lo invalidano. Tra il periodo in cui DataRelation viene creato e aggiunto a DataRelationCollection, è possibile apportare modifiche aggiuntive alle righe padre o figlio. Se si verifica una relazione non più valida, viene generata un'eccezione.

DataRelation gli oggetti sono contenuti in un DataRelationCollectionoggetto , a cui è possibile accedere tramite la Relations proprietà dell'oggetto DataSete le ChildRelations proprietà e ParentRelations di DataTable.

Thread safety

Questo tipo è sicuro per le operazioni di lettura multithreading. È necessario sincronizzare tutte le operazioni di scrittura.

Vedi anche

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