DataRelation Osztály

Definíció

Névtér:

System.Data

Szerelvények:

netstandard.dll, System.Data.Common.dll

Forrás:

DataRelation.cs

Két DataTable objektum közötti szülő-gyermek kapcsolatot jelöl.

public ref class DataRelation

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

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

Public Class DataRelation

Öröklődés

Object

DataRelation

Attribútumok

TypeConverterAttribute

Példák

Az alábbi példa létrehoz egy újatDataRelation, és hozzáadja egy DataRelationCollection .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

Megjegyzések

Az A DataRelation két objektum objektumokon keresztüli DataTable összekapcsolására DataColumn szolgál. Egy Ügyfél/Rendelés kapcsolat esetében például a Vevők tábla a szülő, a Rendelések tábla pedig a kapcsolat gyermeke. Ez hasonló az elsődleges kulcs-/idegenkulcs-kapcsolathoz. További információ: Navigating DataRelations.

A szülő- és gyermektáblák egyező oszlopai között kapcsolatok jönnek létre. Vagyis mindkét DataType oszlop értékének azonosnak kell lennie.

A kapcsolatok a szülőtől DataRow a gyermeksorokig különböző változásokat is kaszkádozhatnak. A gyermeksorok értékeinek módosításának szabályozásához adjon hozzá egy értéket ForeignKeyConstraint az ConstraintCollectionDataTable objektumhoz. Ez ConstraintCollection határozza meg, hogy milyen műveletet kell elvégezni egy szülőtábla egy értékének törlésekor vagy frissítésekor.

Amikor létrejön egy DataRelation kapcsolat, először ellenőrzi, hogy létre lehet-e hozni a kapcsolatot. Miután hozzáadta a DataRelationCollectionkapcsolathoz, a rendszer úgy tartja karban a kapcsolatot, hogy letiltja az érvénytelenné váló módosításokat. A létrehozás és a DataRelationhozzáfűzendő időszak DataRelationCollection között a szülő- vagy gyermeksorok további módosításokat hajthatnak végre. A rendszer kivételt hoz létre, ha ez olyan kapcsolatot okoz, amely már nem érvényes.

Note

Adatsérülés akkor fordulhat elő, ha két tábla között kétirányú kapcsolat van meghatározva. A kétirányú reláció két DataRelation olyan objektumból áll, amelyek ugyanazt az oszlopot használják, és a szülő-gyermek szerepkörök át lesznek kapcsolva. Az objektumok mentésekor DataRelation nem keletkezik kivétel, azonban adatsérülés történhet.

DataRelationobjektumokat tartalmaz egy DataRelationCollection, amely a tulajdonságon Relationskeresztül DataSet érhető el, valamint a ChildRelationsParentRelationsDataTable.

Konstruktorok

Name	Description
DataRelation(String, DataColumn, DataColumn, Boolean)	Inicializálja az DataRelation osztály új példányát a megadott névvel, szülő- és gyermekobjektumokkal DataColumn , valamint egy olyan értékkel, amely jelzi, hogy kényszereket szeretne-e létrehozni.
DataRelation(String, DataColumn, DataColumn)	Inicializálja az DataRelation osztály új példányát a megadott DataRelation névvel, valamint a szülő- és gyermekobjektumokkal DataColumn .
DataRelation(String, DataColumn[], DataColumn[], Boolean)	Inicializálja az DataRelation osztály új példányát a megadott név, a szülő- és gyermekobjektumok DataColumn egyező tömbjei, valamint a kényszerek létrehozását jelző érték használatával.
DataRelation(String, DataColumn[], DataColumn[])	Inicializálja az osztály új példányát a DataRelation szülő- és gyermekobjektumok DataRelation megadott DataColumn nevével és egyező tömbjeivel.
DataRelation(String, String, String, String, String, String[], String[], Boolean)	Ez a konstruktor a Visual Studio környezetben a tervezési idő támogatásához érhető el.
DataRelation(String, String, String, String[], String[], Boolean)	Ez a konstruktor a Visual Studio környezetben a tervezési idő támogatásához érhető el.

Tulajdonságok

Name	Description
ChildColumns	Lekéri a kapcsolat gyermekobjektumait DataColumn .
ChildKeyConstraint	Lekéri a ForeignKeyConstraint kapcsolathoz tartozót.
ChildTable	Lekéri a kapcsolat gyermektábláját.
DataSet	Lekéri a DataSetDataRelation hozzá tartozót.
ExtendedProperties	Lekéri a testreszabott tulajdonságokat tároló gyűjteményt.
Nested	Lekéri vagy beállít egy értéket, amely jelzi, hogy az objektumok beágyazottak-e DataRelation .
ParentColumns	Lekéri a DataColumn szülőoszlopokat tartalmazó objektumtömböt DataRelation.
ParentKeyConstraint	Lekéri azokat a UniqueConstraint beállításokat, amelyek garantálják, hogy a szülőoszlop DataRelation értékei egyediek legyenek.
ParentTable	Lekéri ennek DataTablea szülőjének a szülőjeDataRelation.
RelationName	Lekéri vagy beállítja a lekéréshez DataRelation használt nevet a DataRelationCollectionprogramból.

Metódusok

Name	Description
CheckStateForProperty()	Ez a módszer támogatja .NET infrastruktúrát, és nem közvetlenül a kódból való használatra szolgál.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
OnPropertyChanging(PropertyChangedEventArgs)	Ez a tag támogatja .NET infrastruktúrát, és nem közvetlenül a kódból való használatra szolgál.
RaisePropertyChanging(String)	Ez a tag támogatja .NET infrastruktúrát, és nem közvetlenül a kódból való használatra szolgál.
ToString()	Lekéri a RelationName, ha van ilyen.

Szálbiztonság

Ez a típus biztonságos a többszálas olvasási műveletekhez. Minden írási műveletet szinkronizálnia kell.

Lásd még

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