DataSet.EnforceConstraints-Eigenschaft

Ruft einen Wert ab, der angibt, ob bei Aktualisierungen Einschränkungsregeln beachtet werden, oder legt diesen fest.

Namespace: System.Data
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public Property EnforceConstraints As Boolean
'Usage
Dim instance As DataSet
Dim value As Boolean

value = instance.EnforceConstraints

instance.EnforceConstraints = value

public bool EnforceConstraints { get; set; }

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

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

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

public function get EnforceConstraints () : boolean

public function set EnforceConstraints (value : boolean)

Eigenschaftenwert

true, wenn Regeln erzwungen werden, andernfalls false. Der Standardwert ist true.

Ausnahmen

Ausnahmetyp	Bedingung
ConstraintException	Mindestens eine Einschränkung kann nicht erzwungen werden.

Hinweise

Einschränkungen werden auf der DataTable-Ebene festgelegt (Constraints-Eigenschaft). Weitere Informationen über das Erstellen von Einschränkungen finden Sie unter Hinzufügen von Einschränkungen zu einer Tabelle.

Beispiel

Im folgenden Beispiel wird ein DataSet mit einer Tabelle, einer Spalte, fünf Zeilen und einer UniqueConstraint erstellt. Die EnforceConstraints-Eigenschaft wird auf false festgelegt, und die Werte der einzelnen Zeilen werden auf denselben Wert festgelegt. Wenn die EnforceConstraints-Eigenschaft auf true zurückgesetzt wird, wird eine ConstraintException generiert.

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

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

Plattformen

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

DataSet-Klasse
DataSet-Member
System.Data-Namespace

Weitere Ressourcen

Verwenden von DataSets in ADO.NET