ForeignKeyConstraint Construtores

Referência

Definição

Namespace:: System.Data

Assembly:: System.Data.Common.dll

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

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

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

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

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)

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

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

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

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)

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

Origem:: ForeignKeyConstraint.cs

Origem:: ForeignKeyConstraint.cs

Origem:: ForeignKeyConstraint.cs

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: 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

Compartilhar via

ForeignKeyConstraint Construtores

Definição

Sobrecargas

ForeignKeyConstraint(DataColumn, DataColumn)

Parâmetros

Exceções

Exemplos

Aplica-se a

ForeignKeyConstraint(DataColumn[], DataColumn[])

Parâmetros

Exceções

Exemplos

Aplica-se a

ForeignKeyConstraint(String, DataColumn, DataColumn)

Parâmetros

Exceções

Exemplos

Aplica-se a

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

Parâmetros

Exceções

Exemplos

Aplica-se a

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

Parâmetros

Exceções

Aplica-se a

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

Parâmetros

Exceções

Aplica-se a

Recursos adicionais