DataTable.Constraints-Eigenschaft
Ruft die Auflistung der Einschränkungen ab, die von dieser Tabelle verwaltet werden.
Namespace: System.Data
Assembly: System.Data (in system.data.dll)
Syntax
'Declaration
Public ReadOnly Property Constraints As ConstraintCollection
'Usage
Dim instance As DataTable
Dim value As ConstraintCollection
value = instance.Constraints
public ConstraintCollection Constraints { get; }
public:
property ConstraintCollection^ Constraints {
ConstraintCollection^ get ();
}
/** @property */
public ConstraintCollection get_Constraints ()
public function get Constraints () : ConstraintCollection
Eigenschaftenwert
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.
Hinweise
Eine ForeignKeyConstraint schränkt die Aktion ein, die beim Löschen oder Aktualisieren eines Werts in einer oder mehreren Spalten ausgeführt wird. Eine solche Einschränkung ist für die Verwendung mit Primärschlüsselspalten vorgesehen. In einer Beziehung zwischen einer übergeordneten und einer untergeordneten Tabelle 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 ebenfalls gelöscht werden (eine Kettenaktion).
Die Werte in der untergeordneten Spalte bzw. den untergeordneten Spalten können auf NULL-Werte festgelegt werden.
Die Werte in der untergeordneten Spalte bzw. den untergeordneten Spalten können auf Standardwerte festgelegt werden.
Eine Ausnahme kann ausgelöst werden.
Beim Versuch, einen Wert in einem Primärschlüssel auf einen nicht eindeutigen Wert festzulegen, wird eine UniqueConstraint aktiv.
Beispiel
Im folgenden Beispiel wird der Auflistung von Einschränkungen eine ForeignKeyConstraint hinzugefügt.
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
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;
}
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
DataTable-Klasse
DataTable-Member
System.Data-Namespace