ForeignKeyConstraint Construtores

Definição

Namespace:: System.Data

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Inicializa uma nova instância da classe ForeignKeyConstraint.

Sobrecargas

Nome	Description
ForeignKeyConstraint(DataColumn, DataColumn)	Inicializa uma nova instância da ForeignKeyConstraint classe com os objetos pai e filho DataColumn especificados.
ForeignKeyConstraint(DataColumn[], DataColumn[])	Inicializa uma nova instância da ForeignKeyConstraint classe com as matrizes especificadas de objetos pai e filho DataColumn .
ForeignKeyConstraint(String, DataColumn, DataColumn)	Inicializa uma nova instância da ForeignKeyConstraint classe com o nome, os objetos pai e filho DataColumn especificados.
ForeignKeyConstraint(String, DataColumn[], DataColumn[])	Inicializa uma nova instância da ForeignKeyConstraint classe com o nome especificado e matrizes de objetos pai e filho DataColumn .
ForeignKeyConstraint(String, String, String[], String[], AcceptRejectRule, Rule, Rule)	Esse construtor é fornecido para suporte a tempo de design no ambiente do Visual Studio. ForeignKeyConstraint os objetos criados usando esse construtor devem ser adicionados à coleção por meio de AddRange(Constraint[]). Tabelas e colunas com os nomes especificados devem existir no momento em que o método é chamado ou se BeginInit() tiver sido chamado antes de chamar esse construtor, as tabelas e colunas com os nomes especificados devem existir no momento em que EndInit() for chamado.
ForeignKeyConstraint(String, String, String, String[], String[], AcceptRejectRule, Rule, Rule)	Esse construtor é fornecido para suporte a tempo de design no ambiente do Visual Studio. ForeignKeyConstraint os objetos criados usando esse construtor devem ser adicionados à coleção por meio de AddRange(Constraint[]). Tabelas e colunas com os nomes especificados devem existir no momento em que o método é chamado ou se BeginInit() tiver sido chamado antes de chamar esse construtor, as tabelas e colunas com os nomes especificados devem existir no momento em que EndInit() for chamado.

ForeignKeyConstraint(DataColumn, DataColumn)

Inicializa uma nova instância da ForeignKeyConstraint classe com os objetos pai e filho 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

O pai DataColumn na restrição.

childColumn: DataColumn

O filho DataColumn na restrição.

Exceções

ArgumentNullException

Uma ou ambas as colunas são null.

InvalidConstraintException

As colunas têm tipos de dados diferentes.

-Ou-

As tabelas não pertencem ao mesmo DataSet.

Exemplos

O exemplo a seguir cria um novo ForeignKeyConstraint, define algumas de suas propriedades e o adiciona a um DataTable objeto 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

Aplica-se a

ForeignKeyConstraint(DataColumn[], DataColumn[])

Inicializa uma nova instância da ForeignKeyConstraint classe com as matrizes especificadas de objetos pai e filho 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[]

Uma matriz de pai DataColumn na restrição.

childColumns: DataColumn[]

Uma matriz de filho DataColumn na restrição.

Exceções

ArgumentNullException

Uma ou ambas as colunas são null.

InvalidConstraintException

As colunas têm tipos de dados diferentes.

-Ou-

As tabelas não pertencem ao mesmo DataSet.

Exemplos

O exemplo a seguir cria um novo ForeignKeyConstraint, define algumas de suas propriedades e o adiciona a um DataTable objeto 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

Aplica-se a

ForeignKeyConstraint(String, DataColumn, DataColumn)

Inicializa uma nova instância da ForeignKeyConstraint classe com o nome, os objetos pai e filho 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

O nome da restrição.

parentColumn: DataColumn

O pai DataColumn na restrição.

childColumn: DataColumn

O filho DataColumn na restrição.

Exceções

ArgumentNullException

Uma ou ambas as colunas são null.

InvalidConstraintException

As colunas têm tipos de dados diferentes.

-Ou-

As tabelas não pertencem ao mesmo DataSet.

Exemplos

O exemplo a seguir cria um novo ForeignKeyConstraint, define algumas de suas propriedades e o adiciona a um DataTable objeto 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

Aplica-se a

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

Inicializa uma nova instância da ForeignKeyConstraint classe com o nome especificado e matrizes de objetos pai e filho 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

O nome do ForeignKeyConstraint. Se null ou cadeia de caracteres vazia, um nome padrão será fornecido quando adicionado à coleção de restrições.

parentColumns: DataColumn[]

Uma matriz de pai DataColumn na restrição.

childColumns: DataColumn[]

Uma matriz de filho DataColumn na restrição.

Exceções

ArgumentNullException

Uma ou ambas as colunas são null.

InvalidConstraintException

As colunas têm tipos de dados diferentes.

-Ou-

As tabelas não pertencem ao mesmo DataSet.

Exemplos

O exemplo a seguir cria um novo ForeignKeyConstraint, define algumas de suas propriedades e o adiciona a um DataTable objeto 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

Aplica-se a

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

Esse construtor é fornecido para suporte a tempo de design no ambiente do Visual Studio. ForeignKeyConstraint os objetos criados usando esse construtor devem ser adicionados à coleção por meio de AddRange(Constraint[]). Tabelas e colunas com os nomes especificados devem existir no momento em que o método é chamado ou se BeginInit() tiver sido chamado antes de chamar esse construtor, as tabelas e colunas com os nomes especificados devem existir no momento em que EndInit() for chamado.

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

O nome da restrição.

parentTableName: String

O nome do pai DataTable que contém objetos pai DataColumn na restrição.

parentColumnNames: String[]

Uma matriz dos nomes dos objetos pai DataColumn na restrição.

childColumnNames: String[]

Uma matriz dos nomes de objetos filho DataColumn na restrição.

acceptRejectRule: AcceptRejectRule

Um dos AcceptRejectRule valores. Os valores possíveis incluem None, Cascade e Default.

deleteRule: Rule

Um dos valores a Rule serem usados quando uma linha é excluída. O padrão é Cascade. Os valores possíveis incluem: None, , Cascade, SetNull, SetDefaulte Default.

updateRule: Rule

Um dos valores a Rule serem usados quando uma linha é atualizada. O padrão é Cascade. Os valores possíveis incluem: None, , Cascade, SetNull, SetDefaulte Default.

Atributos: BrowsableAttribute

Exceções

ArgumentNullException

Uma ou ambas as colunas são null.

InvalidConstraintException

As colunas têm tipos de dados diferentes.

-Ou-

As tabelas não pertencem ao mesmo DataSet.

Aplica-se 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

O nome da restrição.

parentTableName: String

O nome do pai DataTable que contém objetos pai DataColumn na restrição.

parentTableNamespace: String

O nome do Namespace.

parentColumnNames: String[]

Uma matriz dos nomes dos objetos pai DataColumn na restrição.

childColumnNames: String[]

Uma matriz dos nomes de objetos filho DataColumn na restrição.

acceptRejectRule: AcceptRejectRule

Um dos AcceptRejectRule valores. Os valores possíveis incluem None, Cascade e Default.

deleteRule: Rule

Um dos valores a Rule serem usados quando uma linha é excluída. O padrão é Cascade. Os valores possíveis incluem: None, , Cascade, SetNull, SetDefaulte Default.

updateRule: Rule

Um dos valores a Rule serem usados quando uma linha é atualizada. O padrão é Cascade. Os valores possíveis incluem: None, , Cascade, SetNull, SetDefaulte Default.

Atributos: BrowsableAttribute

Exceções

ArgumentNullException

Uma ou ambas as colunas são null.

InvalidConstraintException

As colunas têm tipos de dados diferentes.

-Ou-

As tabelas não pertencem ao mesmo DataSet.

Aplica-se a

Comentários

Esta página foi útil?