DataTable.Constraints Eigenschaft

Definition

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Quelle:

DataTable.cs

Ruft die Auflistung der Einschränkungen ab, die von dieser Tabelle verwaltet werden.

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

public System.Data.ConstraintCollection Constraints { get; }

member this.Constraints : System.Data.ConstraintCollection

Public ReadOnly Property Constraints As ConstraintCollection

Eigenschaftswert

ConstraintCollection

Eine ConstraintCollection, die die Auflistung von Constraint-Objekten für die Tabelle enthält. Wenn keine Constraint-Objekte vorhanden sind, wird eine leere Auflistung zurückgegeben.

Beispiele

Im folgenden Beispiel wird der Auflistung von Einschränkungen ein ForeignKeyConstraint hinzugefügt.

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

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

Hinweise

Ein ForeignKeyConstraint schränkt die Aktion ein, die ausgeführt wird, wenn ein Wert in einer Spalte (oder Spalten) entweder gelöscht oder aktualisiert wird. Eine solche Einschränkung ist für die Verwendung mit Primärschlüsselspalten vorgesehen. In einer über-/untergeordneten Beziehung zwischen zwei Tabellen kann sich das Löschen eines Werts aus der übergeordneten Tabelle auf eine der folgenden Arten auf die untergeordneten Zeilen auswirken.

• Die untergeordneten Zeilen können auch gelöscht werden (eine kaskadierende Aktion).

• Die Werte in der untergeordneten Spalte (oder Spalten) können auf NULL-Werte festgelegt werden.

• Die Werte in der untergeordneten Spalte (oder Spalten) können auf Standardwerte festgelegt werden.

• Eine Ausnahme kann generiert werden.

Ein UniqueConstraint wird aktiv, wenn versucht wird, einen Wert in einem Primärschlüssel auf einen nicht eindeutigen Wert festzulegen.

Weitere Informationen

• "DataTables"