DataSet.EnforceConstraints プロパティ

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

DataSet.EnforceConstraints プロパティ

更新操作を試みたときに操作が制約規則に従っているかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property EnforceConstraints As
 Boolean

Visual Basic (使用法)

Dim instance As DataSet
Dim value As Boolean

value = instance.EnforceConstraints

instance.EnforceConstraints = value

C#

public bool EnforceConstraints { get;
 set; }

C++

public:
property bool EnforceConstraints {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_EnforceConstraints ()

/** @property */
public void set_EnforceConstraints (boolean
 value)

JScript

public function get EnforceConstraints
 () : boolean

public function set EnforceConstraints
 (value : boolean)

プロパティ値
規則が適用されている場合は true。それ以外の場合は false。既定値は true です。

例外

例外の種類	条件
ConstraintException	1 つ以上の制約を適用できません。

解説

制約は、DataTable レベル (Constraints プロパティ) で設定されます。制約の作成に関する詳細については、「テーブルへの制約の追加」を参照してください。

使用例

1 つのテーブル、1 列、5 行、および 1 つの UniqueConstraint で DataSet を作成する例を次に示します。EnforceConstraints プロパティが false に設定され、各行の値が同じ値に設定されています。EnforceConstraints プロパティを true にリセットすると、ConstraintException が生成されます。

Visual Basic

Private Sub DemonstrateEnforceConstraints()
    ' Create a DataSet with one table, one column and 
    ' a UniqueConstraint.
    Dim dataSet As DataSet = New
 DataSet("dataSet")
    Dim table As DataTable = New
 DataTable("table")
    Dim column As DataColumn = New
 DataColumn("col1")
    column.Unique = True
    table.Columns.Add(column)
    dataSet.Tables.Add(table)
    Console.WriteLine("constraints.count: " _
        & table.Constraints.Count)

    ' add five rows.
    Dim row As DataRow
    Dim i As Integer
    For i = 0 To 4
       row = table.NewRow()
       row("col1") = i
       table.Rows.Add(row)
    Next
    table.AcceptChanges()
     
    dataSet.EnforceConstraints = False
    ' Change the values of all rows to 1.
    Dim thisRow As DataRow
    For Each thisRow In
 table.rows
       thisRow("col1") = 1
    Next
 
    Try
        dataSet.EnforceConstraints = True
    Catch e As System.Data.ConstraintException
        ' Process exception and return.
        Console.WriteLine("Exception of type {0} occurred.",
 _
            e.GetType().ToString())
    End Try
End Sub

C#

private void DemonstrateEnforceConstraints()
{
    // Create a DataSet with one table, one column and 
    // a UniqueConstraint.
    DataSet dataSet= new DataSet("dataSet");
    DataTable table = new DataTable("table");
    DataColumn column = new DataColumn("col1");

    // A UniqueConstraint is added when the Unique 
    // property is true.
    column.Unique=true;
    table.Columns.Add(column);
    dataSet.Tables.Add(table);
    Console.WriteLine("constraints.count: " + 
        table.Constraints.Count);

    // add five rows.
    DataRow row ;
    for(int i=0;i<5;i++)
    {
        row = table.NewRow();
        row["col1"] = i;
        table.Rows.Add(row);
    }
    table.AcceptChanges();

    dataSet.EnforceConstraints=false;
    // Change the values of all rows to 1.
    foreach(DataRow thisRow in table.Rows)
    {
        thisRow["col1"]=1;
        //Console.WriteLine("\table" + thisRow[0]);
    }
    try
    {
        dataSet.EnforceConstraints=true;
    }
    catch(System.Data.ConstraintException e)
    {
        // Process exception and return.
        Console.WriteLine("Exception of type {0} occurred.", 
            e.GetType());
    }
}

プラットフォーム

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

参照

関連項目
DataSet クラス
DataSet メンバ
System.Data 名前空間
その他の技術情報
ADO.NET での DataSet の使用