DataTable.Constraints プロパティ

.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

C#

public ConstraintCollection Constraints { get;
 }

C++

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

J#

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

JScript

public function get Constraints
 () : ConstraintCollection

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

解説

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

• 子行も削除されます (連鎖アクション)。

• 1 つ以上の子列内の値が null 値に設定されます。

• 1 つ以上の子列内の値が既定値に設定されます。

• 例外が生成されます。

主キー内の値を一意でない値に設定しようとすると、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

C#

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;
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
DataTable クラス
DataTable メンバ
System.Data 名前空間
その他の技術情報
DataTable の作成と使用