ForeignKeyConstraint.DeleteRule-Eigenschaft

Ruft die Aktion ab, die für diese Einschränkung beim Löschen einer Zeile ausgeführt wird, oder legt diese fest.

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

Syntax

'Declaration
Public Overridable Property DeleteRule As Rule
'Usage
Dim instance As ForeignKeyConstraint
Dim value As Rule

value = instance.DeleteRule

instance.DeleteRule = value

public virtual Rule DeleteRule { get; set; }

public:
virtual property Rule DeleteRule {
    Rule get ();
    void set (Rule value);
}

/** @property */
public Rule get_DeleteRule ()

/** @property */
public void set_DeleteRule (Rule value)

public function get DeleteRule () : Rule

public function set DeleteRule (value : Rule)

Eigenschaftenwert

Einer der Rule-Werte. Der Standardwert ist Cascade.

Hinweise

Wenn eine Zeile aus einer übergeordneten Tabelle gelöscht wird, bestimmt die DeleteRule, welche Aktionen in den Spalten der untergeordneten Tabelle bzw. Tabellen ausgeführt werden. Wenn die Regel auf Cascade festgelegt ist, werden untergeordnete Spalten gelöscht.

Wenn sie auf SetNull festgelegt ist, wird DBnull in den entsprechenden Spalten der betroffenen Zeilen platziert. Abhängig von der jeweiligen Datenquelle kann ein NULL-Wert in einer Spalte zulässig oder unzulässig sein. SQL Server lässt z. B. mehrere NULL-Werte in einer Primärschlüsselspalte zu, selbst wenn sie nicht eindeutig sind. In einer DataTable sind jedoch mehrere NULL-Werte in Primärschlüsselspalten unzulässig, wenn die Unique-Eigenschaft eines DataColumn-Objekts auf true festgelegt ist.

Wenn sie auf SetDefault festgelegt ist, wird der Standardwert für die Spalte zugewiesen.

Beispiel

Im folgenden Beispiel wird eine ForeignKeyConstraint erstellt, mehrere ihrer Eigenschaften werden festgelegt, und sie wird der 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 fkConstraint As ForeignKeyConstraint

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

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

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

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

ForeignKeyConstraint-Klasse
ForeignKeyConstraint-Member
System.Data-Namespace