Freigeben über


ForeignKeyConstraint Konstruktoren

Definition

Initialisiert eine neue Instanz der ForeignKeyConstraint-Klasse.

Überlädt

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 und den angegebenen übergeordneten und untergeordneten DataColumn-Objekten.

ForeignKeyConstraint(String, DataColumn[], DataColumn[])

Initialisiert eine neue Instanz der ForeignKeyConstraint-Klasse mit dem angegebenen Namen und den Arrays von übergeordneten und untergeordneten DataColumn-Objekten.

ForeignKeyConstraint(String, String, String[], String[], AcceptRejectRule, Rule, Rule)

Dieser Konstruktor wird für die Unterstützung zur Entwurfszeit in der Visual Studio-Umgebung bereitgestellt. Mit diesem Konstruktor erstellte ForeignKeyConstraint-Objekte müssen der Auflistung anschließend über AddRange(Constraint[]) hinzugefügt werden. Tabellen und Spalten mit den angegebenen Namen müssen zum Zeitpunkt des Aufrufs der Methode vorhanden sein. Wenn BeginInit() vor dem Aufrufen dieses Konstruktors aufgerufen wurde, müssen die Tabellen und Spalten mit den angegebenen Namen zum Zeitpunkt des Aufrufs von EndInit() vorhanden sein.

ForeignKeyConstraint(String, String, String, String[], String[], AcceptRejectRule, Rule, Rule)

Dieser Konstruktor wird für die Unterstützung zur Entwurfszeit in der Visual Studio-Umgebung bereitgestellt. Mit diesem Konstruktor erstellte ForeignKeyConstraint-Objekte müssen der Auflistung anschließend über AddRange(Constraint[]) hinzugefügt werden. Tabellen und Spalten mit den angegebenen Namen müssen zum Zeitpunkt des Aufrufs der Methode vorhanden sein. Wenn BeginInit() vor dem Aufrufen dieses Konstruktors aufgerufen wurde, müssen die Tabellen und Spalten mit den angegebenen Namen zum Zeitpunkt des Aufrufs von EndInit() vorhanden sein.

ForeignKeyConstraint(DataColumn, DataColumn)

Quelle:
ForeignKeyConstraint.cs
Quelle:
ForeignKeyConstraint.cs
Quelle:
ForeignKeyConstraint.cs

Initialisiert eine neue Instanz der ForeignKeyConstraint-Klasse mit den angegebenen übergeordneten und untergeordneten DataColumn-Objekten.

public:
 ForeignKeyConstraint(System::Data::DataColumn ^ parentColumn, System::Data::DataColumn ^ childColumn);
public ForeignKeyConstraint (System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn);
new System.Data.ForeignKeyConstraint : System.Data.DataColumn * System.Data.DataColumn -> System.Data.ForeignKeyConstraint
Public Sub New (parentColumn As DataColumn, childColumn As DataColumn)

Parameter

parentColumn
DataColumn

Die übergeordnete DataColumn in der Einschränkung.

childColumn
DataColumn

Die untergeordnete DataColumn in der Einschränkung.

Ausnahmen

Eine oder beide der Spalten sind null.

Die Spalten weisen unterschiedliche Datentypen auf.

– oder –

Die Tabellen gehören nicht zu demselben DataSet.

Beispiele

Im folgenden Beispiel wird eine neue ForeignKeyConstrainterstellt, legt einige seiner Eigenschaften fest und fügt sie dem -Objekt ConstraintCollectionhinzuDataTable.

' The next line goes into the Declarations section.
' 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(parentColumn, childColumn)

   ' Set various properties of the constraint.
   With fkConstraint
      .ConstraintName = "suppierFKConstraint"
      .DeleteRule = Rule.SetNull
      .UpdateRule = Rule.Cascade
      .AcceptRejectRule = AcceptRejectRule.Cascade
   End With

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

Gilt für:

ForeignKeyConstraint(DataColumn[], DataColumn[])

Quelle:
ForeignKeyConstraint.cs
Quelle:
ForeignKeyConstraint.cs
Quelle:
ForeignKeyConstraint.cs

Initialisiert eine neue Instanz der ForeignKeyConstraint-Klasse mit den angegebenen Arrays von übergeordneten und untergeordneten DataColumn-Objekten.

public:
 ForeignKeyConstraint(cli::array <System::Data::DataColumn ^> ^ parentColumns, cli::array <System::Data::DataColumn ^> ^ childColumns);
public ForeignKeyConstraint (System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns);
new System.Data.ForeignKeyConstraint : System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.ForeignKeyConstraint
Public Sub New (parentColumns As DataColumn(), childColumns As DataColumn())

Parameter

parentColumns
DataColumn[]

Ein Array der übergeordneten DataColumn in der Einschränkung.

childColumns
DataColumn[]

Ein Array der untergeordneten DataColumn in der Auflistung.

Ausnahmen

Eine oder beide der Spalten sind null.

Die Spalten weisen unterschiedliche Datentypen auf.

– oder –

Die Tabellen gehören nicht zu demselben DataSet.

Beispiele

Im folgenden Beispiel wird eine neue ForeignKeyConstrainterstellt, legt einige seiner Eigenschaften fest und fügt sie dem -Objekt ConstraintCollectionhinzuDataTable.

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

Private Sub CreateConstraint()
   ' Declare parent column and child column variables.
   Dim parentColumns(1) As DataColumn
   Dim childColumns(1) As DataColumn
   Dim fkConstraint As ForeignKeyConstraint

   ' Set parent and child column variables.
   parentColumns(0) = _
       suppliersProducts.Tables("OrderDetails").Columns("OrderID")
   parentColumns(1) = _
       suppliersProducts.Tables("OrderDetails").Columns("ProductID")
   childColumns(0) = _
       suppliersProducts.Tables("Sales").Columns("OrderID")
   childColumns(1) = _
       suppliersProducts.Tables("Sales").Columns("ProductID")
   fkConstraint = _
       New ForeignKeyConstraint(parentColumns, childColumns)

   ' Set various properties of the constraint.
   With fkConstraint
      .ConstraintName = "ProductSalesOrders"
      .DeleteRule = Rule.SetDefault
      .UpdateRule = Rule.Cascade
      .AcceptRejectRule = AcceptRejectRule.Cascade
   End With

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

Gilt für:

ForeignKeyConstraint(String, DataColumn, DataColumn)

Quelle:
ForeignKeyConstraint.cs
Quelle:
ForeignKeyConstraint.cs
Quelle:
ForeignKeyConstraint.cs

Initialisiert eine neue Instanz der ForeignKeyConstraint-Klasse mit dem angegebenen Namen und den angegebenen übergeordneten und untergeordneten DataColumn-Objekten.

public:
 ForeignKeyConstraint(System::String ^ constraintName, System::Data::DataColumn ^ parentColumn, System::Data::DataColumn ^ childColumn);
public ForeignKeyConstraint (string? constraintName, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn);
public ForeignKeyConstraint (string constraintName, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn);
new System.Data.ForeignKeyConstraint : string * System.Data.DataColumn * System.Data.DataColumn -> System.Data.ForeignKeyConstraint
Public Sub New (constraintName As String, parentColumn As DataColumn, childColumn As DataColumn)

Parameter

constraintName
String

Der Name der Einschränkung.

parentColumn
DataColumn

Die übergeordnete DataColumn in der Einschränkung.

childColumn
DataColumn

Die untergeordnete DataColumn in der Einschränkung.

Ausnahmen

Eine oder beide der Spalten sind null.

Die Spalten weisen unterschiedliche Datentypen auf.

– oder –

Die Tabellen gehören nicht zu demselben DataSet.

Beispiele

Im folgenden Beispiel wird eine neue ForeignKeyConstrainterstellt, legt einige seiner Eigenschaften fest und fügt sie dem -Objekt ConstraintCollectionhinzuDataTable.

' 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 various properties of the constraint.
   With fkeyConstraint
      .DeleteRule = Rule.SetNull
      .UpdateRule = Rule.Cascade
      .AcceptRejectRule = AcceptRejectRule.Cascade
   End With

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

Gilt für:

ForeignKeyConstraint(String, DataColumn[], DataColumn[])

Quelle:
ForeignKeyConstraint.cs
Quelle:
ForeignKeyConstraint.cs
Quelle:
ForeignKeyConstraint.cs

Initialisiert eine neue Instanz der ForeignKeyConstraint-Klasse mit dem angegebenen Namen und den Arrays von übergeordneten und untergeordneten DataColumn-Objekten.

public:
 ForeignKeyConstraint(System::String ^ constraintName, cli::array <System::Data::DataColumn ^> ^ parentColumns, cli::array <System::Data::DataColumn ^> ^ childColumns);
public ForeignKeyConstraint (string? constraintName, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns);
public ForeignKeyConstraint (string constraintName, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns);
new System.Data.ForeignKeyConstraint : string * System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.ForeignKeyConstraint
Public Sub New (constraintName As String, parentColumns As DataColumn(), childColumns As DataColumn())

Parameter

constraintName
String

Der Name von ForeignKeyConstraint. Wenn null oder eine leere Zeichenfolge, wird beim Hinzufügen zur Auflistung der Einschränkungen ein Standardname zugewiesen.

parentColumns
DataColumn[]

Ein Array der übergeordneten DataColumn in der Einschränkung.

childColumns
DataColumn[]

Ein Array der untergeordneten DataColumn in der Auflistung.

Ausnahmen

Eine oder beide der Spalten sind null.

Die Spalten weisen unterschiedliche Datentypen auf.

– oder –

Die Tabellen gehören nicht zu demselben DataSet.

Beispiele

Im folgenden Beispiel wird eine neue ForeignKeyConstrainterstellt, legt einige seiner Eigenschaften fest und fügt sie dem -Objekt ConstraintCollectionhinzuDataTable.

Private Sub CreateConstraint(ByVal suppliersProducts As DataSet)
    ' Declare parent column and child column variables.
    Dim parentColumns(1) As DataColumn
    Dim childColumns(1) As DataColumn
    Dim fkConstraint As ForeignKeyConstraint

    ' Set parent and child column variables.
    parentColumns(0) = _
        suppliersProducts.Tables("OrderDetails").Columns("OrderID")
    parentColumns(1) = _
        suppliersProducts.Tables("OrderDetails").Columns("ProductID")
    childColumns(0) = _
        suppliersProducts.Tables("Sales").Columns("OrderID")
    childColumns(1) = _
        suppliersProducts.Tables("Sales").Columns("ProductID")
    fkConstraint = New ForeignKeyConstraint( _
        "ProductSalesOrders", parentColumns, childColumns)

    ' Set various properties of the constraint.
    With fkConstraint
        .DeleteRule = Rule.SetDefault
        .UpdateRule = Rule.Cascade
        .AcceptRejectRule = AcceptRejectRule.Cascade
    End With

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

Gilt für:

ForeignKeyConstraint(String, String, String[], String[], AcceptRejectRule, Rule, Rule)

Quelle:
ForeignKeyConstraint.cs
Quelle:
ForeignKeyConstraint.cs
Quelle:
ForeignKeyConstraint.cs

Dieser Konstruktor wird für die Unterstützung zur Entwurfszeit in der Visual Studio-Umgebung bereitgestellt. Mit diesem Konstruktor erstellte ForeignKeyConstraint-Objekte müssen der Auflistung anschließend über AddRange(Constraint[]) hinzugefügt werden. Tabellen und Spalten mit den angegebenen Namen müssen zum Zeitpunkt des Aufrufs der Methode vorhanden sein. Wenn BeginInit() vor dem Aufrufen dieses Konstruktors aufgerufen wurde, müssen die Tabellen und Spalten mit den angegebenen Namen zum Zeitpunkt des Aufrufs von EndInit() vorhanden sein.

public:
 ForeignKeyConstraint(System::String ^ constraintName, System::String ^ parentTableName, cli::array <System::String ^> ^ parentColumnNames, cli::array <System::String ^> ^ childColumnNames, System::Data::AcceptRejectRule acceptRejectRule, System::Data::Rule deleteRule, System::Data::Rule updateRule);
[System.ComponentModel.Browsable(false)]
public ForeignKeyConstraint (string? constraintName, string? parentTableName, string[] parentColumnNames, string[] childColumnNames, System.Data.AcceptRejectRule acceptRejectRule, System.Data.Rule deleteRule, System.Data.Rule updateRule);
[System.ComponentModel.Browsable(false)]
public ForeignKeyConstraint (string constraintName, string parentTableName, string[] parentColumnNames, string[] childColumnNames, System.Data.AcceptRejectRule acceptRejectRule, System.Data.Rule deleteRule, System.Data.Rule updateRule);
[<System.ComponentModel.Browsable(false)>]
new System.Data.ForeignKeyConstraint : string * string * string[] * string[] * System.Data.AcceptRejectRule * System.Data.Rule * System.Data.Rule -> System.Data.ForeignKeyConstraint
Public Sub New (constraintName As String, parentTableName As String, parentColumnNames As String(), childColumnNames As String(), acceptRejectRule As AcceptRejectRule, deleteRule As Rule, updateRule As Rule)

Parameter

constraintName
String

Der Name der Einschränkung.

parentTableName
String

Der Name der übergeordneten DataTable-Klasse, die übergeordnete DataColumn-Objekte in der Einschränkung enthält.

parentColumnNames
String[]

Ein Array der Namen von übergeordneten DataColumn-Objekten in der Einschränkung.

childColumnNames
String[]

Ein Array der Namen von untergeordneten DataColumn-Objekten in der Einschränkung.

acceptRejectRule
AcceptRejectRule

Einer der AcceptRejectRule-Werte. Mögliche Werte sind None, Cascade und Default.

deleteRule
Rule

Einer der Rule-Werte, der beim Löschen einer Zeile verwendet werden soll. Der Standardwert ist Cascade. Mögliche Werte sind: None, Cascade, SetNull, SetDefault und Default.

updateRule
Rule

Einer der Rule-Werte, der beim Aktualisieren einer Zeile verwendet werden soll. Der Standardwert ist Cascade. Mögliche Werte sind: None, Cascade, SetNull, SetDefault und Default.

Attribute

Ausnahmen

Eine oder beide der Spalten sind null.

Die Spalten weisen unterschiedliche Datentypen auf.

– oder –

Die Tabellen gehören nicht zu demselben DataSet.

Gilt für:

ForeignKeyConstraint(String, String, String, String[], String[], AcceptRejectRule, Rule, Rule)

Quelle:
ForeignKeyConstraint.cs
Quelle:
ForeignKeyConstraint.cs
Quelle:
ForeignKeyConstraint.cs

Dieser Konstruktor wird für die Unterstützung zur Entwurfszeit in der Visual Studio-Umgebung bereitgestellt. Mit diesem Konstruktor erstellte ForeignKeyConstraint-Objekte müssen der Auflistung anschließend über AddRange(Constraint[]) hinzugefügt werden. Tabellen und Spalten mit den angegebenen Namen müssen zum Zeitpunkt des Aufrufs der Methode vorhanden sein. Wenn BeginInit() vor dem Aufrufen dieses Konstruktors aufgerufen wurde, müssen die Tabellen und Spalten mit den angegebenen Namen zum Zeitpunkt des Aufrufs von EndInit() vorhanden sein.

public:
 ForeignKeyConstraint(System::String ^ constraintName, System::String ^ parentTableName, System::String ^ parentTableNamespace, cli::array <System::String ^> ^ parentColumnNames, cli::array <System::String ^> ^ childColumnNames, System::Data::AcceptRejectRule acceptRejectRule, System::Data::Rule deleteRule, System::Data::Rule updateRule);
[System.ComponentModel.Browsable(false)]
public ForeignKeyConstraint (string? constraintName, string? parentTableName, string? parentTableNamespace, string[] parentColumnNames, string[] childColumnNames, System.Data.AcceptRejectRule acceptRejectRule, System.Data.Rule deleteRule, System.Data.Rule updateRule);
[System.ComponentModel.Browsable(false)]
public ForeignKeyConstraint (string constraintName, string parentTableName, string parentTableNamespace, string[] parentColumnNames, string[] childColumnNames, System.Data.AcceptRejectRule acceptRejectRule, System.Data.Rule deleteRule, System.Data.Rule updateRule);
[<System.ComponentModel.Browsable(false)>]
new System.Data.ForeignKeyConstraint : string * string * string * string[] * string[] * System.Data.AcceptRejectRule * System.Data.Rule * System.Data.Rule -> System.Data.ForeignKeyConstraint
Public Sub New (constraintName As String, parentTableName As String, parentTableNamespace As String, parentColumnNames As String(), childColumnNames As String(), acceptRejectRule As AcceptRejectRule, deleteRule As Rule, updateRule As Rule)

Parameter

constraintName
String

Der Name der Einschränkung.

parentTableName
String

Der Name der übergeordneten DataTable-Klasse, die übergeordnete DataColumn-Objekte in der Einschränkung enthält.

parentTableNamespace
String

Der Name von Namespace.

parentColumnNames
String[]

Ein Array der Namen von übergeordneten DataColumn-Objekten in der Einschränkung.

childColumnNames
String[]

Ein Array der Namen von untergeordneten DataColumn-Objekten in der Einschränkung.

acceptRejectRule
AcceptRejectRule

Einer der AcceptRejectRule-Werte. Mögliche Werte sind None, Cascade und Default.

deleteRule
Rule

Einer der Rule-Werte, der beim Löschen einer Zeile verwendet werden soll. Der Standardwert ist Cascade. Mögliche Werte sind: None, Cascade, SetNull, SetDefault und Default.

updateRule
Rule

Einer der Rule-Werte, der beim Aktualisieren einer Zeile verwendet werden soll. Der Standardwert ist Cascade. Mögliche Werte sind: None, Cascade, SetNull, SetDefault und Default.

Attribute

Ausnahmen

Eine oder beide der Spalten sind null.

Die Spalten weisen unterschiedliche Datentypen auf.

– oder –

Die Tabellen gehören nicht zu demselben DataSet.

Gilt für: