DataRelation クラス

定義

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

継承

Object

DataRelation

属性

TypeConverterAttribute SerializableAttribute

例

次の例では、新DataRelationしい を作成し、 の DataSetにDataRelationCollection追加します。

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

注釈

DataRelationは、オブジェクトを介して DataColumn 2 つのDataTableオブジェクトを相互に関連付けるために使用されます。 たとえば、Customer/Orders リレーションシップでは、Customers テーブルは親であり、Orders テーブルはリレーションシップの子です。 これは、主キーと外部キーの関係に似ています。 詳細については、「 DataRelations の移動」を参照してください。

リレーションシップは、親テーブルと子テーブルの一致する列の間に作成されます。 つまり、両方の列の DataType 値は同じである必要があります。

リレーションシップは、親 DataRow から子行にさまざまな変更を連鎖することもできます。 子行での値の変更方法を制御するには、 オブジェクトの に をConstraintCollectionDataTable追加ForeignKeyConstraintします。 は ConstraintCollection 、親テーブルの値が削除または更新されたときに実行するアクションを決定します。

DataRelationが作成されると、最初にリレーションシップを確立できることを確認します。 に DataRelationCollection追加された後、リレーションシップは無効になる変更を禁止することで維持されます。 が作成されて に追加される DataRelation 期間の間に DataRelationCollection、親行または子行に追加の変更を加える可能性があります。 これが原因で無効になったリレーションシップが発生すると、例外が生成されます。

DataRelationオブジェクトは、 の DataRelationCollectionプロパティ、および ParentRelationsChildRelationsDataTableの プロパティDataSetをRelations介してアクセスできる に含まれています。

コンストラクター

プロパティ

メソッド

適用対象

スレッド セーフ

この型は、マルチスレッド読み取り操作に安全です。 書き込み操作は同期する必要があります。

こちらもご覧ください

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