DataSet.EnforceConstraints Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Data
Zestaw:
System.Data.Common.dll
Zestaw:
System.Data.dll
Zestaw:
netstandard.dll

Pobiera lub ustawia wartość wskazującą, czy reguły ograniczeń są przestrzegane podczas próby wykonania dowolnej operacji aktualizacji.

public:
 property bool EnforceConstraints { bool get(); void set(bool value); };
public bool EnforceConstraints { get; set; }
[System.Data.DataSysDescription("DataSetEnforceConstraintsDescr")]
public bool EnforceConstraints { get; set; }
member this.EnforceConstraints : bool with get, set
[<System.Data.DataSysDescription("DataSetEnforceConstraintsDescr")>]
member this.EnforceConstraints : bool with get, set
Public Property EnforceConstraints As Boolean

Wartość właściwości

Boolean

true jeśli reguły są wymuszane; w przeciwnym razie , false. Wartość domyślna to true.

Atrybuty
DataSysDescriptionAttribute

Wyjątki

ConstraintException

Nie można wymusić co najmniej jednego ograniczenia.

Przykłady

Poniższy przykład tworzy tabelę z jedną tabelą DataSet , jedną kolumną, pięcioma wierszami i jedną UniqueConstraint. Właściwość jest ustawiona EnforceConstraints na false wartość , a wartości każdego wiersza są ustawione na tę samą wartość. Gdy EnforceConstraints właściwość zostanie zresetowana do trueelementu , ConstraintException zostanie wygenerowana wartość .

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

Private Sub DemonstrateEnforceConstraints()
    ' Create a DataSet with one table, one column and 
    ' a UniqueConstraint.
    Dim dataSet As New DataSet("dataSet")
    Dim table As New DataTable("table")
    Dim column As 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

Uwagi

Ograniczenia są ustawiane na DataTable poziomie (Constraints właściwość). Aby uzyskać więcej informacji na temat tworzenia ograniczeń, zobacz Ograniczenia tabeli danych.

Dotyczy

Zobacz też