DataTable.Constraints プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

DataTable.Constraints プロパティ

このテーブルに保持されている制約のコレクションを取得します。

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 Constraints As ConstraintCollection

Visual Basic (使用法)

Dim instance As DataTable
Dim value As ConstraintCollection

value = instance.Constraints

public ConstraintCollection Constraints { get;
 }

C++

public:
property ConstraintCollection^ Constraints {
    ConstraintCollection^ get ();
}

/** @property */
public ConstraintCollection get_Constraints ()

JScript

public function get Constraints
 () : ConstraintCollection

プロパティ値
テーブルの Constraint オブジェクトのコレクションを格納している ConstraintCollection。Constraint オブジェクトが存在しない場合、空のコレクションが返されます。

解説

ForeignKeyConstraint は、列内の値を削除または更新したときに実行されるアクションを制限します。この制約は主キー列に使用する必要があります。2 つのテーブル間の親子のリレーションシップでは、親テーブルから値を削除すると、子行に対して次のいずれかの影響を与えることがあります。

主キー内の値を一意でない値に設定しようとすると、UniqueConstraint がアクティブになります。

使用例

ForeignKeyConstraint を制約のコレクションに追加する例を次に示します。

Visual Basic

Private Sub CreateConstraint(dataSet As
 DataSet, _
    table1 As String, table2 As
 String, _
    column1 As String, column2 As
 String)

    Dim idKeyRestraint As ForeignKeyConstraint
 = _
        New ForeignKeyConstraint _
        (dataSet.Tables(table1).Columns(column1), _
        dataSet.Tables(table2).Columns(column2))

    ' Set null values when a value is deleted.
    idKeyRestraint.DeleteRule = Rule.SetNull
    idKeyRestraint.UpdateRule = Rule.Cascade

    ' Set AcceptRejectRule to cascade changes.
    idKeyRestraint.AcceptRejectRule = AcceptRejectRule.Cascade
    
    dataSet.Tables(table1).Constraints.Add(idKeyRestraint)
    dataSet.EnforceConstraints = True
End Sub

private void CreateConstraint(DataSet dataSet,
 
    string table1, string table2, string
 column1, string column2)
{
    ForeignKeyConstraint idKeyRestraint = new 
        ForeignKeyConstraint(dataSet.Tables[table1].Columns[column1],
        dataSet.Tables[table2].Columns[column2]);

    // Set null values when a value is deleted.
    idKeyRestraint.DeleteRule = Rule.SetNull;
    idKeyRestraint.UpdateRule = Rule.Cascade;

    // Set AcceptRejectRule to cascade changes.
    idKeyRestraint.AcceptRejectRule = AcceptRejectRule.Cascade;
 
    dataSet.Tables[table1].Constraints.Add(idKeyRestraint);
    dataSet.EnforceConstraints = true;
}