DataRelation Klasse

Definition

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

Vererbung

Object

DataRelation

Attribute

TypeConverterAttribute SerializableAttribute

Beispiele

Im folgenden Beispiel wird ein neues DataRelation erstellt und dem DataRelationCollection Objekt eines 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

Hinweise

A DataRelation wird verwendet, um zwei DataTable Objekte durch DataColumn Objekte miteinander zu verknüpfen. In einer Beziehung "Kunden/Bestellungen" ist die Tabelle "Kunden" beispielsweise das übergeordnete Element, und die Tabelle "Bestellungen" ist das untergeordnete Element der Beziehung. Dies ähnelt einer Primärschlüssel-/Fremdschlüsselbeziehung. Weitere Informationen finden Sie unter Navigieren in DataRelations.

Beziehungen werden zwischen übereinstimmenden Spalten in den übergeordneten und untergeordneten Tabellen erstellt. Das heißt, der DataType Wert für beide Spalten muss identisch sein.

Beziehungen können auch verschiedene Änderungen vom übergeordneten Element DataRow in die untergeordneten Zeilen überlappen. Um zu steuern, wie Werte in untergeordneten Zeilen geändert werden, fügen Sie dem DataTableConstraintCollection Objekt einen Wert ForeignKeyConstraint hinzu. Dies ConstraintCollection bestimmt, welche Aktion ausgeführt werden soll, wenn ein Wert in einer übergeordneten Tabelle gelöscht oder aktualisiert wird.

Beim Erstellen eines Vorgangs DataRelation wird zunächst überprüft, ob die Beziehung hergestellt werden kann. Nachdem sie der DataRelationCollectionBeziehung hinzugefügt wurde, wird die Beziehung beibehalten, indem alle Änderungen deaktiviert werden, die sie ungültig würden. Zwischen dem Zeitraum, in dem DataRelationCollectionein DataRelation Objekt erstellt und dem hinzugefügt wird, ist es möglich, dass zusätzliche Änderungen an den übergeordneten oder untergeordneten Zeilen vorgenommen werden. Eine Ausnahme wird generiert, wenn dies zu einer nicht mehr gültigen Beziehung führt.

DataRelationObjekte sind in einer DataRelationCollection, auf die Sie über die Relations Eigenschaft des DataSet, und die ChildRelationsParentRelations Eigenschaften der .DataTable

Threadsicherheit

Dieser Typ ist für Multithread-Lesevorgänge sicher. Sie müssen alle Schreibvorgänge synchronisieren.

Weitere Informationen

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