ForeignKeyConstraint Konstruktoren

Definition

Initialisiert eine neue Instanz der ForeignKeyConstraint-Klasse.Initializes a new instance of the ForeignKeyConstraint class.

Überlädt

ForeignKeyConstraint(DataColumn, DataColumn)

Initialisiert eine neue Instanz der ForeignKeyConstraint-Klasse mit den angegebenen übergeordneten und untergeordneten DataColumn-Objekten.Initializes a new instance of the ForeignKeyConstraint class with the specified parent and child DataColumn objects.

ForeignKeyConstraint(DataColumn[], DataColumn[])

Initialisiert eine neue Instanz der ForeignKeyConstraint-Klasse mit den angegebenen Arrays von übergeordneten und untergeordneten DataColumn-Objekten.Initializes a new instance of the ForeignKeyConstraint class with the specified arrays of parent and child DataColumn objects.

ForeignKeyConstraint(String, DataColumn, DataColumn)

Initialisiert eine neue Instanz der ForeignKeyConstraint-Klasse mit dem angegebenen Namen und den angegebenen übergeordneten und untergeordneten DataColumn-Objekten.Initializes a new instance of the ForeignKeyConstraint class with the specified name, parent and child DataColumn objects.

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

Initialisiert eine neue Instanz der ForeignKeyConstraint-Klasse mit dem angegebenen Namen und den Arrays von übergeordneten und untergeordneten DataColumn-Objekten.Initializes a new instance of the ForeignKeyConstraint class with the specified name, and arrays of parent and child DataColumn objects.

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

Dieser Konstruktor wird für die Unterstützung zur Entwurfszeit in der Visual Studio-Umgebung bereitgestellt.This constructor is provided for design time support in the Visual Studio environment. Mit diesem Konstruktor erstellte ForeignKeyConstraint-Objekte müssen der Auflistung anschließend über AddRange(Constraint[]) hinzugefügt werden.ForeignKeyConstraint objects created by using this constructor must then be added to the collection via AddRange(Constraint[]). 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.Tables and columns with the specified names must exist at the time the method is called, or if BeginInit() has been called prior to calling this constructor, the tables and columns with the specified names must exist at the time that EndInit() is called.

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.This constructor is provided for design time support in the Visual Studio environment. Mit diesem Konstruktor erstellte ForeignKeyConstraint-Objekte müssen der Auflistung anschließend über AddRange(Constraint[]) hinzugefügt werden.ForeignKeyConstraint objects created by using this constructor must then be added to the collection via AddRange(Constraint[]). 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.Tables and columns with the specified names must exist at the time the method is called, or if BeginInit() has been called prior to calling this constructor, the tables and columns with the specified names must exist at the time that EndInit() is called.

ForeignKeyConstraint(DataColumn, DataColumn)

Initialisiert eine neue Instanz der ForeignKeyConstraint-Klasse mit den angegebenen übergeordneten und untergeordneten DataColumn-Objekten.Initializes a new instance of the ForeignKeyConstraint class with the specified parent and child DataColumn objects.

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.The parent DataColumn in the constraint.

childColumn
DataColumn

Die untergeordnete DataColumn in der Einschränkung.The child DataColumn in the constraint.

Ausnahmen

Eine oder beide der Spalten sind null.One or both of the columns is null.

Die Spalten weisen unterschiedliche Datentypen auf.The columns have different data types.

– oder –-Or - Die Tabellen gehören nicht zu demselben DataSet.The tables don't belong to the same DataSet.

Beispiele

Im folgenden Beispiel wird eine neue ForeignKeyConstrainterstellt, einige der zugehörigen Eigenschaften festgelegt und dem ConstraintCollectiondes DataTable-Objekts hinzugefügt.The following example creates a new ForeignKeyConstraint, sets some of its properties, and adds it to a DataTable object's ConstraintCollection.

' 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

ForeignKeyConstraint(DataColumn[], DataColumn[])

Initialisiert eine neue Instanz der ForeignKeyConstraint-Klasse mit den angegebenen Arrays von übergeordneten und untergeordneten DataColumn-Objekten.Initializes a new instance of the ForeignKeyConstraint class with the specified arrays of parent and child DataColumn objects.

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.An array of parent DataColumn in the constraint.

childColumns
DataColumn[]

Ein Array der untergeordneten DataColumn in der Auflistung.An array of child DataColumn in the constraint.

Ausnahmen

Eine oder beide der Spalten sind null.One or both of the columns is null.

Die Spalten weisen unterschiedliche Datentypen auf.The columns have different data types.

– oder –-Or - Die Tabellen gehören nicht zu demselben DataSet.The tables don't belong to the same DataSet.

Beispiele

Im folgenden Beispiel wird eine neue ForeignKeyConstrainterstellt, einige der zugehörigen Eigenschaften festgelegt und dem ConstraintCollectiondes DataTable-Objekts hinzugefügt.The following example creates a new ForeignKeyConstraint, sets some of its properties, and adds it to a DataTable object's ConstraintCollection.

' 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

ForeignKeyConstraint(String, DataColumn, DataColumn)

Initialisiert eine neue Instanz der ForeignKeyConstraint-Klasse mit dem angegebenen Namen und den angegebenen übergeordneten und untergeordneten DataColumn-Objekten.Initializes a new instance of the ForeignKeyConstraint class with the specified name, parent and child DataColumn objects.

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);
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.The name of the constraint.

parentColumn
DataColumn

Die übergeordnete DataColumn in der Einschränkung.The parent DataColumn in the constraint.

childColumn
DataColumn

Die untergeordnete DataColumn in der Einschränkung.The child DataColumn in the constraint.

Ausnahmen

Eine oder beide der Spalten sind null.One or both of the columns is null.

Die Spalten weisen unterschiedliche Datentypen auf.The columns have different data types.

– oder –-Or - Die Tabellen gehören nicht zu demselben DataSet.The tables don't belong to the same DataSet.

Beispiele

Im folgenden Beispiel wird eine neue ForeignKeyConstrainterstellt, einige der zugehörigen Eigenschaften festgelegt und dem ConstraintCollectiondes DataTable-Objekts hinzugefügt.The following example creates a new ForeignKeyConstraint, sets some of its properties, and adds it to a DataTable object's ConstraintCollection.

' 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

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

Initialisiert eine neue Instanz der ForeignKeyConstraint-Klasse mit dem angegebenen Namen und den Arrays von übergeordneten und untergeordneten DataColumn-Objekten.Initializes a new instance of the ForeignKeyConstraint class with the specified name, and arrays of parent and child DataColumn objects.

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);
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 des ForeignKeyConstraint-Objekts.The name of the ForeignKeyConstraint. Wenn null oder eine leere Zeichenfolge, wird beim Hinzufügen zur Auflistung der Einschränkungen ein Standardname zugewiesen.If null or empty string, a default name will be given when added to the constraints collection.

parentColumns
DataColumn[]

Ein Array der übergeordneten DataColumn in der Einschränkung.An array of parent DataColumn in the constraint.

childColumns
DataColumn[]

Ein Array der untergeordneten DataColumn in der Auflistung.An array of child DataColumn in the constraint.

Ausnahmen

Eine oder beide der Spalten sind null.One or both of the columns is null.

Die Spalten weisen unterschiedliche Datentypen auf.The columns have different data types.

– oder –-Or - Die Tabellen gehören nicht zu demselben DataSet.The tables don't belong to the same DataSet.

Beispiele

Im folgenden Beispiel wird eine neue ForeignKeyConstrainterstellt, einige der zugehörigen Eigenschaften festgelegt und dem ConstraintCollectiondes DataTable-Objekts hinzugefügt.The following example creates a new ForeignKeyConstraint, sets some of its properties, and adds it to a DataTable object's ConstraintCollection.

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

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

Dieser Konstruktor wird für die Unterstützung zur Entwurfszeit in der Visual Studio-Umgebung bereitgestellt.This constructor is provided for design time support in the Visual Studio environment. Mit diesem Konstruktor erstellte ForeignKeyConstraint-Objekte müssen der Auflistung anschließend über AddRange(Constraint[]) hinzugefügt werden.ForeignKeyConstraint objects created by using this constructor must then be added to the collection via AddRange(Constraint[]). 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.Tables and columns with the specified names must exist at the time the method is called, or if BeginInit() has been called prior to calling this constructor, the tables and columns with the specified names must exist at the time that EndInit() is called.

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);
new System.Data.ForeignKeyConstraint : string * string * string[] * string[] * System.Data.AcceptRejectRule * System.Data.Rule * System.Data.Rule -> System.Data.ForeignKeyConstraint

Parameter

constraintName
String

Der Name der Einschränkung.The name of the constraint.

parentTableName
String

Der Name der übergeordneten DataTable-Klasse, die übergeordnete DataColumn-Objekte in der Einschränkung enthält.The name of the parent DataTable that contains parent DataColumn objects in the constraint.

parentColumnNames
String[]

Ein Array der Namen von übergeordneten DataColumn-Objekten in der Einschränkung.An array of the names of parent DataColumn objects in the constraint.

childColumnNames
String[]

Ein Array der Namen von untergeordneten DataColumn-Objekten in der Einschränkung.An array of the names of child DataColumn objects in the constraint.

acceptRejectRule
AcceptRejectRule

Einer der AcceptRejectRule-Werte.One of the AcceptRejectRule values. Mögliche Werte: None, Cascade und Default.Possible values include None, Cascade, and Default.

deleteRule
Rule

Einer der Rule-Werte, der beim Löschen einer Zeile verwendet werden soll.One of the Rule values to use when a row is deleted. Der Standardwert ist Cascade.The default is Cascade. Mögliche Werte sind: None, Cascade, SetNull, SetDefault und Default.Possible values include: None, Cascade, SetNull, SetDefault, and Default.

updateRule
Rule

Einer der Rule-Werte, der beim Aktualisieren einer Zeile verwendet werden soll.One of the Rule values to use when a row is updated. Der Standardwert ist Cascade.The default is Cascade. Mögliche Werte sind: None, Cascade, SetNull, SetDefault und Default.Possible values include: None, Cascade, SetNull, SetDefault, and Default.

Attribute

Ausnahmen

Eine oder beide der Spalten sind null.One or both of the columns is null.

Die Spalten weisen unterschiedliche Datentypen auf.The columns have different data types.

– oder –-Or - Die Tabellen gehören nicht zu demselben DataSet.The tables don't belong to the same DataSet.

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.This constructor is provided for design time support in the Visual Studio environment. Mit diesem Konstruktor erstellte ForeignKeyConstraint-Objekte müssen der Auflistung anschließend über AddRange(Constraint[]) hinzugefügt werden.ForeignKeyConstraint objects created by using this constructor must then be added to the collection via AddRange(Constraint[]). 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.Tables and columns with the specified names must exist at the time the method is called, or if BeginInit() has been called prior to calling this constructor, the tables and columns with the specified names must exist at the time that EndInit() is called.

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);
new System.Data.ForeignKeyConstraint : string * string * string * string[] * string[] * System.Data.AcceptRejectRule * System.Data.Rule * System.Data.Rule -> System.Data.ForeignKeyConstraint

Parameter

constraintName
String

Der Name der Einschränkung.The name of the constraint.

parentTableName
String

Der Name der übergeordneten DataTable-Klasse, die übergeordnete DataColumn-Objekte in der Einschränkung enthält.The name of the parent DataTable that contains parent DataColumn objects in the constraint.

parentTableNamespace
String

Der Name des Namespace-Objekts.The name of the Namespace.

parentColumnNames
String[]

Ein Array der Namen von übergeordneten DataColumn-Objekten in der Einschränkung.An array of the names of parent DataColumn objects in the constraint.

childColumnNames
String[]

Ein Array der Namen von untergeordneten DataColumn-Objekten in der Einschränkung.An array of the names of child DataColumn objects in the constraint.

acceptRejectRule
AcceptRejectRule

Einer der AcceptRejectRule-Werte.One of the AcceptRejectRule values. Mögliche Werte: None, Cascade und Default.Possible values include None, Cascade, and Default.

deleteRule
Rule

Einer der Rule-Werte, der beim Löschen einer Zeile verwendet werden soll.One of the Rule values to use when a row is deleted. Der Standardwert ist Cascade.The default is Cascade. Mögliche Werte sind: None, Cascade, SetNull, SetDefault und Default.Possible values include: None, Cascade, SetNull, SetDefault, and Default.

updateRule
Rule

Einer der Rule-Werte, der beim Aktualisieren einer Zeile verwendet werden soll.One of the Rule values to use when a row is updated. Der Standardwert ist Cascade.The default is Cascade. Mögliche Werte sind: None, Cascade, SetNull, SetDefault und Default.Possible values include: None, Cascade, SetNull, SetDefault, and Default.

Attribute

Ausnahmen

Eine oder beide der Spalten sind null.One or both of the columns is null.

Die Spalten weisen unterschiedliche Datentypen auf.The columns have different data types.

– oder –-Or - Die Tabellen gehören nicht zu demselben DataSet.The tables don't belong to the same DataSet.

Gilt für: