ForeignKeyConstraint Klasse

Definition

Namespace:

System.Data

Assemblys:

netstandard.dll, System.Data.Common.dll

Quelle:

ForeignKeyConstraint.cs

Stellt eine Aktionseinschränkung dar, die für eine Reihe von Spalten in einer Primärschlüssel-/Fremdschlüsselbeziehung erzwungen wird, wenn ein Wert oder eine Zeile entweder gelöscht oder aktualisiert wird.

public ref class ForeignKeyConstraint : System::Data::Constraint

public class ForeignKeyConstraint : System.Data.Constraint

type ForeignKeyConstraint = class
    inherit Constraint

Public Class ForeignKeyConstraint
Inherits Constraint

Vererbung

Object

Constraint

ForeignKeyConstraint

Beispiele

Im folgenden Beispiel wird ein ForeignKeyConstraint, legt einige seiner Eigenschaften fest und fügt es zu den DataTable Objekten ConstraintCollectionhinzu.

' 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

Hinweise

Eine ForeignKeyConstraint Einschränkung der Aktion, die ausgeführt wird, wenn ein Wert in einer Spalte (oder Spalten) entweder gelöscht oder aktualisiert wird. Eine solche Einschränkung soll mit Primärschlüsselspalten verwendet werden. In einer 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.

ForeignKeyConstraint Objekte befinden sich in einem ConstraintCollectionDataTable, auf das über die Constraints Eigenschaft zugegriffen wird.

Einschränkungen werden nur erzwungen, wenn die EnforceConstraints Eigenschaft auf true.

Dies AcceptRejectRule wird erzwungen, wenn die Methode eines DataTable Objekts AcceptChanges aufgerufen wird.

Konstruktoren

Name	Beschreibung
ForeignKeyConstraint(DataColumn, DataColumn)	Initialisiert eine neue Instanz der ForeignKeyConstraint Klasse mit den angegebenen übergeordneten und untergeordneten DataColumn Objekten.
ForeignKeyConstraint(DataColumn[], DataColumn[])	Initialisiert eine neue Instanz der ForeignKeyConstraint Klasse mit den angegebenen Arrays von übergeordneten und untergeordneten DataColumn Objekten.
ForeignKeyConstraint(String, DataColumn, DataColumn)	Initialisiert eine neue Instanz der ForeignKeyConstraint Klasse mit dem angegebenen Namen, übergeordneten und untergeordneten DataColumn Objekten.
ForeignKeyConstraint(String, DataColumn[], DataColumn[])	Initialisiert eine neue Instanz der ForeignKeyConstraint Klasse mit dem angegebenen Namen und Arrays von übergeordneten und untergeordneten DataColumn Objekten.
ForeignKeyConstraint(String, String, String, String[], String[], AcceptRejectRule, Rule, Rule)	Dieser Konstruktor wird für die Entwurfszeitunterstützung in der Visual Studio-Umgebung bereitgestellt. ForeignKeyConstraint Mithilfe dieses Konstruktors erstellte Objekte müssen dann der Auflistung über AddRange(Constraint[])hinzugefügt werden. Tabellen und Spalten mit den angegebenen Namen müssen zum Zeitpunkt des Aufrufs der Methode vorhanden sein, oder wenn BeginInit() sie vor dem Aufrufen dieses Konstruktors aufgerufen wurde, müssen die Tabellen und Spalten mit den angegebenen Namen zum Zeitpunkt EndInit() des Aufrufs vorhanden sein.
ForeignKeyConstraint(String, String, String[], String[], AcceptRejectRule, Rule, Rule)	Dieser Konstruktor wird für die Entwurfszeitunterstützung in der Visual Studio-Umgebung bereitgestellt. ForeignKeyConstraint Mithilfe dieses Konstruktors erstellte Objekte müssen dann der Auflistung über AddRange(Constraint[])hinzugefügt werden. Tabellen und Spalten mit den angegebenen Namen müssen zum Zeitpunkt des Aufrufs der Methode vorhanden sein, oder wenn BeginInit() sie vor dem Aufrufen dieses Konstruktors aufgerufen wurde, müssen die Tabellen und Spalten mit den angegebenen Namen zum Zeitpunkt EndInit() des Aufrufs vorhanden sein.

Eigenschaften

Name	Beschreibung
_DataSet	Ruft die DataSet Einschränkung ab, zu der diese Einschränkung gehört. (Geerbt von Constraint)
AcceptRejectRule	Gibt die Aktion an, die bei AcceptChanges() Aufruf dieser Einschränkung ausgeführt werden soll.
Columns	Ruft die untergeordneten Spalten dieser Einschränkung ab.
ConstraintName	Der Name einer Einschränkung in der ConstraintCollection. (Geerbt von Constraint)
DeleteRule	Ruft die Aktion ab, die in dieser Einschränkung auftritt, wenn eine Zeile gelöscht wird, oder legt sie fest.
ExtendedProperties	Ruft die Auflistung benutzerdefinierter Einschränkungseigenschaften ab. (Geerbt von Constraint)
RelatedColumns	Die übergeordneten Spalten dieser Einschränkung.
RelatedTable	Ruft die übergeordnete Tabelle dieser Einschränkung ab.
Table	Ruft die untergeordnete Tabelle dieser Einschränkung ab.
UpdateRule	Dient zum Abrufen oder Festlegen der Aktion, die in dieser Einschränkung auftritt, wenn eine Zeile aktualisiert wird.

Methoden

Name	Beschreibung
CheckStateForProperty()	Ruft die DataSet Einschränkung ab, zu der diese Einschränkung gehört. (Geerbt von Constraint)
Equals(Object)	Ruft einen Wert ab, der angibt, ob der aktuelle ForeignKeyConstraint mit dem angegebenen Objekt identisch ist.
GetHashCode()	Ruft den Hashcode dieser Instanz des ForeignKeyConstraint Objekts ab.
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
SetDataSet(DataSet)	Legt die Einschränkung fest DataSet. (Geerbt von Constraint)
ToString()	Ruft den ConstraintName, falls vorhanden, als Zeichenfolge ab. (Geerbt von Constraint)

Threadsicherheit

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

Weitere Informationen

• AcceptRejectRule
• DataTable
• ConstraintCollection
• Rule