DataRelation Třída

Definice

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

Dědičnost

Object

DataRelation

Atributy

TypeConverterAttribute SerializableAttribute

Příklady

Následující příklad vytvoří nový DataRelation a přidá ho do 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

Poznámky

Slouží DataRelation k vzájemnému spojení dvou DataTable objektů prostřednictvím DataColumn objektů. Například v relaci Zákazník/Objednávky je tabulka Zákazníci nadřazenou tabulkou a tabulka Objednávky je podřízeným objektem relace. Podobá se relaci primárního klíče a cizího klíče. Další informace najdete v tématu Navigating DataRelations.

Relace se vytvářejí mezi odpovídajícími sloupci v nadřazené a podřízené tabulce. To znamená, že DataType hodnota obou sloupců musí být stejná.

Relace mohou také kaskádovat různé změny z nadřazeného DataRow do podřízených řádků. Pokud chcete určit, jak se mění hodnoty v podřízených řádcích, přidejte ForeignKeyConstraint do objektu ConstraintCollection objekt .DataTable Určuje ConstraintCollection , jaká akce se má provést při odstranění nebo aktualizaci hodnoty v nadřazené tabulce.

DataRelation Při vytvoření se nejprve ověří, že je možné vytvořit relaci. Po přidání do DataRelationCollectionse vztah zachová tak, že zakáže všechny změny, které by ji zneplatní. Mezi obdobím, kdy DataRelation je vytvořen a přidán do DataRelationCollection, je možné provést další změny v nadřazených nebo podřízených řádcích. Výjimka se vygeneruje, pokud to způsobí vztah, který už není platný.

DataRelation Objekty jsou obsaženy v objektu DataRelationCollection, ke kterému můžete přistupovat prostřednictvím Relations vlastnosti objektu DataSeta ChildRelations vlastností a ParentRelations objektu DataTable.

Konstruktory

Vlastnosti

Metody

Platí pro

Bezpečný přístup z více vláken

Tento typ je bezpečný pro operace čtení ve více vláknech. Je nutné synchronizovat všechny operace zápisu.

Viz také

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