Compartilhar via


ForeignKeyConstraint Construtores

Definição

Inicializa uma nova instância da classe ForeignKeyConstraint.

Sobrecargas

ForeignKeyConstraint(DataColumn, DataColumn)

Inicializa uma nova instância da classe ForeignKeyConstraint com os objetos DataColumn pai e filho especificados.

ForeignKeyConstraint(DataColumn[], DataColumn[])

Inicializa uma nova instância da classe ForeignKeyConstraint com as matrizes especificadas de objetos DataColumn pai e filho.

ForeignKeyConstraint(String, DataColumn, DataColumn)

Inicializa uma nova instância da classe ForeignKeyConstraint com o nome especificado e objetos DataColumn pai e filho.

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

Inicializa uma nova instância da classe ForeignKeyConstraint com o nome especificado, bem como matrizes de objetos DataColumn pai e filho.

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

Este construtor é fornecido para suporte de tempo de design no ambiente do Visual Studio. Os objetos ForeignKeyConstraint criados usando este construtor, em seguida, devem ser adicionados à coleção via AddRange(Constraint[]). Tabelas e colunas com os nomes especificados devem existir no momento em que o método é chamado ou se BeginInit() foi chamado antes de se chamar este construtor, as tabelas e colunas com os nomes especificados devem existir no momento em que EndInit() é chamado.

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

Este construtor é fornecido para suporte de tempo de design no ambiente do Visual Studio. Os objetos ForeignKeyConstraint criados usando este construtor, em seguida, devem ser adicionados à coleção via AddRange(Constraint[]). Tabelas e colunas com os nomes especificados devem existir no momento em que o método é chamado ou se BeginInit() foi chamado antes de se chamar este construtor, as tabelas e colunas com os nomes especificados devem existir no momento em que EndInit() é chamado.

ForeignKeyConstraint(DataColumn, DataColumn)

Origem:
ForeignKeyConstraint.cs
Origem:
ForeignKeyConstraint.cs
Origem:
ForeignKeyConstraint.cs

Inicializa uma nova instância da classe ForeignKeyConstraint com os objetos DataColumn pai e filho 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 DataColumn pai na restrição.

childColumn
DataColumn

O DataColumn filho na restrição.

Exceções

Uma ou ambas as colunas são null.

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

Origem:
ForeignKeyConstraint.cs
Origem:
ForeignKeyConstraint.cs
Origem:
ForeignKeyConstraint.cs

Inicializa uma nova instância da classe ForeignKeyConstraint com as matrizes especificadas de objetos DataColumn pai e filho.

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 DataColumn pai na restrição.

childColumns
DataColumn[]

Uma matriz de DataColumn filho na restrição.

Exceções

Uma ou ambas as colunas são null.

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)

Origem:
ForeignKeyConstraint.cs
Origem:
ForeignKeyConstraint.cs
Origem:
ForeignKeyConstraint.cs

Inicializa uma nova instância da classe ForeignKeyConstraint com o nome especificado e objetos DataColumn pai e filho.

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)

Parâmetros

constraintName
String

O nome da restrição.

parentColumn
DataColumn

O DataColumn pai na restrição.

childColumn
DataColumn

O DataColumn filho na restrição.

Exceções

Uma ou ambas as colunas são null.

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

Origem:
ForeignKeyConstraint.cs
Origem:
ForeignKeyConstraint.cs
Origem:
ForeignKeyConstraint.cs

Inicializa uma nova instância da classe ForeignKeyConstraint com o nome especificado, bem como matrizes de objetos DataColumn pai e filho.

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

Parâmetros

constraintName
String

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

parentColumns
DataColumn[]

Uma matriz de DataColumn pai na restrição.

childColumns
DataColumn[]

Uma matriz de DataColumn filho na restrição.

Exceções

Uma ou ambas as colunas são null.

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)

Origem:
ForeignKeyConstraint.cs
Origem:
ForeignKeyConstraint.cs
Origem:
ForeignKeyConstraint.cs

Este construtor é fornecido para suporte de tempo de design no ambiente do Visual Studio. Os objetos ForeignKeyConstraint criados usando este construtor, em seguida, devem ser adicionados à coleção via AddRange(Constraint[]). Tabelas e colunas com os nomes especificados devem existir no momento em que o método é chamado ou se BeginInit() foi chamado antes de se chamar este construtor, as tabelas e colunas com os nomes especificados devem existir no momento em que EndInit() é 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)]
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 DataColumn pai na restrição.

parentColumnNames
String[]

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

childColumnNames
String[]

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

acceptRejectRule
AcceptRejectRule

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

deleteRule
Rule

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

updateRule
Rule

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

Atributos

Exceções

Uma ou ambas as colunas são null.

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)

Origem:
ForeignKeyConstraint.cs
Origem:
ForeignKeyConstraint.cs
Origem:
ForeignKeyConstraint.cs

Este construtor é fornecido para suporte de tempo de design no ambiente do Visual Studio. Os objetos ForeignKeyConstraint criados usando este construtor, em seguida, devem ser adicionados à coleção via AddRange(Constraint[]). Tabelas e colunas com os nomes especificados devem existir no momento em que o método é chamado ou se BeginInit() foi chamado antes de se chamar este construtor, as tabelas e colunas com os nomes especificados devem existir no momento em que EndInit() é chamado.

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)

Parâmetros

constraintName
String

O nome da restrição.

parentTableName
String

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

parentTableNamespace
String

O nome do Namespace.

parentColumnNames
String[]

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

childColumnNames
String[]

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

acceptRejectRule
AcceptRejectRule

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

deleteRule
Rule

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

updateRule
Rule

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

Atributos

Exceções

Uma ou ambas as colunas são null.

As colunas têm tipos de dados diferentes.

- Ou -

As tabelas não pertencem ao mesmo DataSet.

Aplica-se a