ForeignKeyConstraint Constructores

Definición

Espacio de nombres:: System.Data

Ensamblado:: System.Data.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Inicializa una nueva instancia de la clase ForeignKeyConstraint.

Sobrecargas

Nombre	Description
ForeignKeyConstraint(DataColumn, DataColumn)	Inicializa una nueva instancia de la ForeignKeyConstraint clase con los objetos primarios y secundarios DataColumn especificados.
ForeignKeyConstraint(DataColumn[], DataColumn[])	Inicializa una nueva instancia de la ForeignKeyConstraint clase con las matrices especificadas de objetos primarios y secundarios DataColumn .
ForeignKeyConstraint(String, DataColumn, DataColumn)	Inicializa una nueva instancia de la ForeignKeyConstraint clase con el nombre, los objetos primarios y secundarios DataColumn especificados.
ForeignKeyConstraint(String, DataColumn[], DataColumn[])	Inicializa una nueva instancia de la ForeignKeyConstraint clase con el nombre especificado y matrices de objetos primarios y secundarios DataColumn .
ForeignKeyConstraint(String, String, String[], String[], AcceptRejectRule, Rule, Rule)	Este constructor se proporciona para la compatibilidad con tiempo de diseño en el entorno de Visual Studio. ForeignKeyConstraint Los objetos creados mediante este constructor deben agregarse a la colección a través AddRange(Constraint[])de . Las tablas y columnas con los nombres especificados deben existir en el momento en que se llama al método, o si BeginInit() se ha llamado antes de llamar a este constructor, las tablas y columnas con los nombres especificados deben existir en el momento en que EndInit() se llama a .
ForeignKeyConstraint(String, String, String, String[], String[], AcceptRejectRule, Rule, Rule)	Este constructor se proporciona para la compatibilidad con tiempo de diseño en el entorno de Visual Studio. ForeignKeyConstraint Los objetos creados mediante este constructor deben agregarse a la colección a través AddRange(Constraint[])de . Las tablas y columnas con los nombres especificados deben existir en el momento en que se llama al método, o si BeginInit() se ha llamado antes de llamar a este constructor, las tablas y columnas con los nombres especificados deben existir en el momento en que EndInit() se llama a .

ForeignKeyConstraint(DataColumn, DataColumn)

Inicializa una nueva instancia de la ForeignKeyConstraint clase con los objetos primarios y secundarios DataColumn especificados.

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)

Parámetros

parentColumn: DataColumn

Elemento primario DataColumn de la restricción.

childColumn: DataColumn

Elemento secundario DataColumn de la restricción.

Excepciones

ArgumentNullException

Una o ambas columnas son null.

InvalidConstraintException

Las columnas tienen tipos de datos diferentes.

-O -

Las tablas no pertenecen al mismo DataSet.

Ejemplos

En el ejemplo siguiente se crea un nuevo ForeignKeyConstraint, se establecen algunas de sus propiedades y se agregan a DataTable 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

Se aplica a

ForeignKeyConstraint(DataColumn[], DataColumn[])

Inicializa una nueva instancia de la ForeignKeyConstraint clase con las matrices especificadas de objetos primarios y secundarios 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())

Parámetros

parentColumns: DataColumn[]

Matriz de elementos primarios DataColumn de la restricción.

childColumns: DataColumn[]

Matriz de elementos secundarios DataColumn de la restricción.

Excepciones

ArgumentNullException

Una o ambas columnas son null.

InvalidConstraintException

Las columnas tienen tipos de datos diferentes.

-O -

Las tablas no pertenecen al mismo DataSet.

Ejemplos

En el ejemplo siguiente se crea un nuevo ForeignKeyConstraint, se establecen algunas de sus propiedades y se agregan a DataTable 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

Se aplica a

ForeignKeyConstraint(String, DataColumn, DataColumn)

Inicializa una nueva instancia de la ForeignKeyConstraint clase con el nombre, los objetos primarios y secundarios DataColumn especificados.

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)

Parámetros

constraintName: String

Nombre de la restricción.

parentColumn: DataColumn

Elemento primario DataColumn de la restricción.

childColumn: DataColumn

Elemento secundario DataColumn de la restricción.

Excepciones

ArgumentNullException

Una o ambas columnas son null.

InvalidConstraintException

Las columnas tienen tipos de datos diferentes.

-O -

Las tablas no pertenecen al mismo DataSet.

Ejemplos

En el ejemplo siguiente se crea un nuevo ForeignKeyConstraint, se establecen algunas de sus propiedades y se agregan a DataTable 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

Se aplica a

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

Inicializa una nueva instancia de la ForeignKeyConstraint clase con el nombre especificado y matrices de objetos primarios y secundarios 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())

Parámetros

constraintName: String

El nombre del ForeignKeyConstraint. Si null o está vacía, se proporcionará un nombre predeterminado cuando se agregue a la colección de restricciones.

parentColumns: DataColumn[]

Matriz de elementos primarios DataColumn de la restricción.

childColumns: DataColumn[]

Matriz de elementos secundarios DataColumn de la restricción.

Excepciones

ArgumentNullException

Una o ambas columnas son null.

InvalidConstraintException

Las columnas tienen tipos de datos diferentes.

-O -

Las tablas no pertenecen al mismo DataSet.

Ejemplos

En el ejemplo siguiente se crea un nuevo ForeignKeyConstraint, se establecen algunas de sus propiedades y se agregan a DataTable 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

Se aplica a

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

Este constructor se proporciona para la compatibilidad con tiempo de diseño en el entorno de Visual Studio. ForeignKeyConstraint Los objetos creados mediante este constructor deben agregarse a la colección a través AddRange(Constraint[])de . Las tablas y columnas con los nombres especificados deben existir en el momento en que se llama al método, o si BeginInit() se ha llamado antes de llamar a este constructor, las tablas y columnas con los nombres especificados deben existir en el momento en que EndInit() se llama a .

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)

Parámetros

constraintName: String

Nombre de la restricción.

parentTableName: String

Nombre del elemento primario DataTable que contiene objetos primarios DataColumn en la restricción .

parentColumnNames: String[]

Matriz de los nombres de los objetos primarios DataColumn de la restricción.

childColumnNames: String[]

Matriz de los nombres de los objetos secundarios DataColumn de la restricción.

acceptRejectRule: AcceptRejectRule

Uno de los AcceptRejectRule valores. Los valores posibles incluyen None, Cascade y Default.

deleteRule: Rule

Uno de los Rule valores que se van a usar cuando se elimina una fila. El valor predeterminado es Cascade. Entre los valores posibles se incluyen: None, Cascade, SetNull, SetDefaulty Default.

updateRule: Rule

Uno de los Rule valores que se van a usar cuando se actualiza una fila. El valor predeterminado es Cascade. Entre los valores posibles se incluyen: None, Cascade, SetNull, SetDefaulty Default.

Atributos: BrowsableAttribute

Excepciones

ArgumentNullException

Una o ambas columnas son null.

InvalidConstraintException

Las columnas tienen tipos de datos diferentes.

-O -

Las tablas no pertenecen al mismo DataSet.

Se aplica a

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)

Parámetros

constraintName: String

Nombre de la restricción.

parentTableName: String

Nombre del elemento primario DataTable que contiene objetos primarios DataColumn en la restricción .

parentTableNamespace: String

El nombre del Namespace.

parentColumnNames: String[]

Matriz de los nombres de los objetos primarios DataColumn de la restricción.

childColumnNames: String[]

Matriz de los nombres de los objetos secundarios DataColumn de la restricción.

acceptRejectRule: AcceptRejectRule

Uno de los AcceptRejectRule valores. Los valores posibles incluyen None, Cascade y Default.

deleteRule: Rule

updateRule: Rule

Atributos: BrowsableAttribute

Excepciones

ArgumentNullException

Una o ambas columnas son null.

InvalidConstraintException

Las columnas tienen tipos de datos diferentes.

-O -

Las tablas no pertenecen al mismo DataSet.

Se aplica a

Comentarios

¿Le ha resultado útil esta página?