DataSet.EnforceConstraints Eigenschap

Definitie

Naamruimte:
System.Data
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of er beperkingenregels worden gevolgd bij het uitvoeren van een updatebewerking.

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

Waarde van eigenschap

Boolean

true als er regels worden afgedwongen; anders, false. De standaardwaarde is true.

Kenmerken
DataSysDescriptionAttribute

Uitzonderingen

ConstraintException

Een of meer beperkingen kunnen niet worden afgedwongen.

Voorbeelden

In het volgende voorbeeld wordt een DataSet met één tabel, één kolom, vijf rijen en één UniqueConstraintgemaakt. De EnforceConstraints eigenschap is ingesteld op false en de waarden van elke rij worden ingesteld op dezelfde waarde. Wanneer de EnforceConstraints eigenschap opnieuw wordt ingesteld true, wordt er een ConstraintException gegenereerd.

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

Opmerkingen

Beperkingen worden ingesteld op het DataTable niveau (Constraints eigenschap). Zie DataTable-beperkingen voor meer informatie over het maken van beperkingen.

Van toepassing op

Zie ook