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 lo aggiunge all'oggetto DataRelationCollection di un DataSetoggetto .

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

Viene DataRelation usato 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 è 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. Vale a dire, il DataType valore per entrambe le colonne deve essere identico.

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

Quando viene creato un oggetto DataRelation , verifica prima di tutto che la relazione possa essere stabilita. Dopo l'aggiunta all'oggetto DataRelationCollection, la relazione viene mantenuta non consentendo alcuna modifica che lo invaliderebbe. Tra il periodo in cui viene DataRelation creato e aggiunto a DataRelationCollection, è possibile apportare modifiche aggiuntive alle righe padre o figlio. Un'eccezione viene generata se questa causa una relazione che non è più valida.

DataRelationgli oggetti sono contenuti in un DataRelationCollectionoggetto , che è possibile accedere tramite la Relations proprietà dell'oggetto e le ChildRelations proprietà e ParentRelations dell'oggetto DataSetDataTable.

Costruttori

Proprietà

Metodi

Si applica a

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