ForeignKeyConstraint Konstruktoren

Referenz

Definition

Namespace:: System.Data

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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)

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

ArgumentNullException

Eine oder beide der Spalten sind null.

InvalidConstraintException

Die Spalten weisen unterschiedliche Datentypen auf.

– oder – Die Tabellen gehören nicht zu demselben DataSet.

Beispiele

Im folgenden Beispiel wird ein neues ForeignKeyConstraint, einige seiner Eigenschaften festgelegt und dem Objekt ConstraintCollectionhinzugefügtDataTable.

' 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[])

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

ArgumentNullException

Eine oder beide der Spalten sind null.

InvalidConstraintException

Die Spalten weisen unterschiedliche Datentypen auf.

– oder – Die Tabellen gehören nicht zu demselben DataSet.

Beispiele

Im folgenden Beispiel wird ein neues ForeignKeyConstraint, einige seiner Eigenschaften festgelegt und dem Objekt ConstraintCollectionhinzugefügtDataTable.

' 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)

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

ArgumentNullException

Eine oder beide der Spalten sind null.

InvalidConstraintException

Die Spalten weisen unterschiedliche Datentypen auf.

– oder – Die Tabellen gehören nicht zu demselben DataSet.

Beispiele

Im folgenden Beispiel wird ein neues ForeignKeyConstraint, einige seiner Eigenschaften festgelegt und dem Objekt ConstraintCollectionhinzugefügtDataTable.

' 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[])

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

ArgumentNullException

Eine oder beide der Spalten sind null.

InvalidConstraintException

Die Spalten weisen unterschiedliche Datentypen auf.

– oder – Die Tabellen gehören nicht zu demselben DataSet.

Beispiele

Im folgenden Beispiel wird ein neues ForeignKeyConstraint, einige seiner Eigenschaften festgelegt und dem Objekt ConstraintCollectionhinzugefügtDataTable.

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)

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: BrowsableAttribute

Ausnahmen

ArgumentNullException

Eine oder beide der Spalten sind null.

InvalidConstraintException

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)

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: BrowsableAttribute

Ausnahmen

ArgumentNullException

Eine oder beide der Spalten sind null.

InvalidConstraintException

Die Spalten weisen unterschiedliche Datentypen auf.

– oder – Die Tabellen gehören nicht zu demselben DataSet.

Gilt für

ForeignKeyConstraint Konstruktoren

Definition

Überlädt

ForeignKeyConstraint(DataColumn, DataColumn)

Parameter

Ausnahmen

Beispiele

Gilt für

ForeignKeyConstraint(DataColumn[], DataColumn[])

Parameter

Ausnahmen

Beispiele

Gilt für

ForeignKeyConstraint(String, DataColumn, DataColumn)

Parameter

Ausnahmen

Beispiele

Gilt für

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

Parameter

Ausnahmen

Beispiele

Gilt für

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

Parameter

Ausnahmen

Gilt für

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

Parameter

Ausnahmen

Gilt für

Zusätzliche Ressourcen