ForeignKeyConstraint Constructeurs

Définition

Espace de noms:: System.Data

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Initialise une nouvelle instance de la classe ForeignKeyConstraint.

Surcharges

Nom	Description
ForeignKeyConstraint(DataColumn, DataColumn)	Initialise une nouvelle instance de la ForeignKeyConstraint classe avec les objets parent et enfant DataColumn spécifiés.
ForeignKeyConstraint(DataColumn[], DataColumn[])	Initialise une nouvelle instance de la ForeignKeyConstraint classe avec les tableaux spécifiés d’objets parents et enfants DataColumn .
ForeignKeyConstraint(String, DataColumn, DataColumn)	Initialise une nouvelle instance de la ForeignKeyConstraint classe avec le nom, le parent et les objets enfants DataColumn spécifiés.
ForeignKeyConstraint(String, DataColumn[], DataColumn[])	Initialise une nouvelle instance de la ForeignKeyConstraint classe avec le nom spécifié et les tableaux d’objets parent et enfant DataColumn .
ForeignKeyConstraint(String, String, String[], String[], AcceptRejectRule, Rule, Rule)	Ce constructeur est fourni pour la prise en charge du temps de conception dans l’environnement Visual Studio. ForeignKeyConstraint les objets créés à l’aide de ce constructeur doivent ensuite être ajoutés à la collection via AddRange(Constraint[]). Les tables et colonnes avec les noms spécifiés doivent exister au moment où la méthode est appelée, ou si BeginInit() elle a été appelée avant d’appeler ce constructeur, les tables et colonnes avec les noms spécifiés doivent exister au moment de l’appel EndInit() .
ForeignKeyConstraint(String, String, String, String[], String[], AcceptRejectRule, Rule, Rule)	Ce constructeur est fourni pour la prise en charge du temps de conception dans l’environnement Visual Studio. ForeignKeyConstraint les objets créés à l’aide de ce constructeur doivent ensuite être ajoutés à la collection via AddRange(Constraint[]). Les tables et colonnes avec les noms spécifiés doivent exister au moment où la méthode est appelée, ou si BeginInit() elle a été appelée avant d’appeler ce constructeur, les tables et colonnes avec les noms spécifiés doivent exister au moment de l’appel EndInit() .

ForeignKeyConstraint(DataColumn, DataColumn)

Initialise une nouvelle instance de la ForeignKeyConstraint classe avec les objets parent et enfant DataColumn spécifiés.

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)

Paramètres

parentColumn: DataColumn

Parent DataColumn dans la contrainte.

childColumn: DataColumn

Enfant DataColumn dans la contrainte.

Exceptions

ArgumentNullException

Une ou les deux colonnes est null.

InvalidConstraintException

Les colonnes ont des types de données différents.

-Ou-

Les tables n’appartiennent pas au même DataSet.

Exemples

L’exemple suivant crée un ForeignKeyConstraintnouveau , définit certaines de ses propriétés et l’ajoute à l’objet ConstraintCollection DataTable .

' 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

S’applique à

ForeignKeyConstraint(DataColumn[], DataColumn[])

Initialise une nouvelle instance de la ForeignKeyConstraint classe avec les tableaux spécifiés d’objets parents et enfants DataColumn .

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

Paramètres

parentColumns: DataColumn[]

Tableau de parents DataColumn dans la contrainte.

childColumns: DataColumn[]

Tableau d’enfants DataColumn dans la contrainte.

Exceptions

ArgumentNullException

Une ou les deux colonnes est null.

InvalidConstraintException

Les colonnes ont des types de données différents.

-Ou-

Les tables n’appartiennent pas au même DataSet.

Exemples

L’exemple suivant crée un ForeignKeyConstraintnouveau , définit certaines de ses propriétés et l’ajoute à l’objet ConstraintCollection DataTable .

' 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

S’applique à

ForeignKeyConstraint(String, DataColumn, DataColumn)

Initialise une nouvelle instance de la ForeignKeyConstraint classe avec le nom, le parent et les objets enfants DataColumn spécifiés.

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)

Paramètres

constraintName: String

Nom de la contrainte.

parentColumn: DataColumn

Parent DataColumn dans la contrainte.

childColumn: DataColumn

Enfant DataColumn dans la contrainte.

Exceptions

ArgumentNullException

Une ou les deux colonnes est null.

InvalidConstraintException

Les colonnes ont des types de données différents.

-Ou-

Les tables n’appartiennent pas au même DataSet.

Exemples

L’exemple suivant crée un ForeignKeyConstraintnouveau , définit certaines de ses propriétés et l’ajoute à l’objet ConstraintCollection DataTable .

' 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

S’applique à

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

Initialise une nouvelle instance de la ForeignKeyConstraint classe avec le nom spécifié et les tableaux d’objets parent et enfant DataColumn .

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

Paramètres

constraintName: String

Nom du ForeignKeyConstraint. Si null ou chaîne vide, un nom par défaut est attribué lorsqu’il est ajouté à la collection de contraintes.

parentColumns: DataColumn[]

Tableau de parents DataColumn dans la contrainte.

childColumns: DataColumn[]

Tableau d’enfants DataColumn dans la contrainte.

Exceptions

ArgumentNullException

Une ou les deux colonnes est null.

InvalidConstraintException

Les colonnes ont des types de données différents.

-Ou-

Les tables n’appartiennent pas au même DataSet.

Exemples

L’exemple suivant crée un ForeignKeyConstraintnouveau , définit certaines de ses propriétés et l’ajoute à l’objet ConstraintCollection DataTable .

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

S’applique à

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

Ce constructeur est fourni pour la prise en charge du temps de conception dans l’environnement Visual Studio. ForeignKeyConstraint les objets créés à l’aide de ce constructeur doivent ensuite être ajoutés à la collection via AddRange(Constraint[]). Les tables et colonnes avec les noms spécifiés doivent exister au moment où la méthode est appelée, ou si BeginInit() elle a été appelée avant d’appeler ce constructeur, les tables et colonnes avec les noms spécifiés doivent exister au moment de l’appel EndInit() .

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

Paramètres

constraintName: String

Nom de la contrainte.

parentTableName: String

Nom du parent DataTable qui contient des objets parents DataColumn dans la contrainte.

parentColumnNames: String[]

Tableau des noms d’objets parents DataColumn dans la contrainte.

childColumnNames: String[]

Tableau des noms d’objets enfants DataColumn dans la contrainte.

acceptRejectRule: AcceptRejectRule

Une des AcceptRejectRule valeurs. Les valeurs possibles incluent None, Cascade et Default.

deleteRule: Rule

Une des Rule valeurs à utiliser lorsqu’une ligne est supprimée. La valeur par défaut est Cascade. Les valeurs possibles sont les suivantes : None, , CascadeSetNull, SetDefault, et Default.

updateRule: Rule

Une des Rule valeurs à utiliser lorsqu’une ligne est mise à jour. La valeur par défaut est Cascade. Les valeurs possibles sont les suivantes : None, , CascadeSetNull, SetDefault, et Default.

Attributs: BrowsableAttribute

Exceptions

ArgumentNullException

Une ou les deux colonnes est null.

InvalidConstraintException

Les colonnes ont des types de données différents.

-Ou-

Les tables n’appartiennent pas au même DataSet.

S’applique à

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

Paramètres

constraintName: String

Nom de la contrainte.

parentTableName: String

Nom du parent DataTable qui contient des objets parents DataColumn dans la contrainte.

parentTableNamespace: String

Nom du Namespace.

parentColumnNames: String[]

Tableau des noms d’objets parents DataColumn dans la contrainte.

childColumnNames: String[]

Tableau des noms d’objets enfants DataColumn dans la contrainte.

acceptRejectRule: AcceptRejectRule

Une des AcceptRejectRule valeurs. Les valeurs possibles incluent None, Cascade et Default.

deleteRule: Rule

updateRule: Rule

Attributs: BrowsableAttribute

Exceptions

ArgumentNullException

Une ou les deux colonnes est null.

InvalidConstraintException

Les colonnes ont des types de données différents.

-Ou-

Les tables n’appartiennent pas au même DataSet.

S’applique à

Commentaires

Cette page a-t-elle été utile ?