ForeignKeyConstraint-Klasse

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.

ForeignKeyConstraint -Objekte sind in der ConstraintCollection einer DataTable enthalten, auf die über die Constraints-Eigenschaft zugegriffen wird.

Einschränkungen werden nur dann erzwungen, wenn die EnforceConstraints-Eigenschaft auf true festgelegt ist.

Die AcceptRejectRule wird immer dann erzwungen, wenn die AcceptChanges-Methode eines DataTable-Objekts aufgerufen wird.

Im folgenden Beispiel wird eine ForeignKeyConstraint erstellt, es werden einige ihrer Eigenschaften festgelegt, und sie wird einer ConstraintCollection eines DataTable-Objekts hinzugefügt.

' The next line goes into the Declarations section of the module:
' SuppliersProducts is a class derived from DataSet.
Private suppliersProducts As SuppliersProducts

Private Sub CreateConstraint()
    ' Declare parent column and child column variables.
    Dim parentColumn As DataColumn
    Dim childColumn As DataColumn
    Dim fkeyConstraint As ForeignKeyConstraint

    ' Set parent and child column variables.
    parentColumn = suppliersProducts.Tables("Suppliers").Columns("SupplierID")
    childColumn = suppliersProducts.Tables("Products").Columns("SupplierID")
    fkeyConstraint = New ForeignKeyConstraint( _
        "SupplierFKConstraint", parentColumn, childColumn)

    ' Set null values when a value is deleted.
    fkeyConstraint.DeleteRule = Rule.SetNull
    fkeyConstraint.UpdateRule = Rule.Cascade
    fkeyConstraint.AcceptRejectRule = AcceptRejectRule.Cascade

    ' Add the constraint, and set EnforceConstraints to true.
    suppliersProducts.Tables("Products").Constraints.Add(fkeyConstraint)
    suppliersProducts.EnforceConstraints = True
End Sub

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Dieser Typ ist bei Multithread-Lesevorgängen sicher. Sie müssen alle Schreibvorgänge synchronisieren.

Referenz