ForeignKeyConstraint Classe

Definição

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Origem:

ForeignKeyConstraint.cs

Representa uma restrição de ação imposta em um conjunto de colunas em uma relação de chave estrangeira/chave primária quando um valor ou uma linha é excluída ou atualizada.

public ref class ForeignKeyConstraint : System::Data::Constraint

public class ForeignKeyConstraint : System.Data.Constraint

type ForeignKeyConstraint = class
    inherit Constraint

Public Class ForeignKeyConstraint
Inherits Constraint

Herança

Object

Constraint

ForeignKeyConstraint

Exemplos

O exemplo a seguir cria um 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 null values when a value is deleted.
    fkeyConstraint.DeleteRule = Rule.SetNull
    fkeyConstraint.UpdateRule = Rule.Cascade
    fkeyConstraint.AcceptRejectRule = AcceptRejectRule.Cascade

    ' Add the constraint, and set EnforceConstraints to true.
    suppliersProducts.Tables("Products").Constraints.Add(fkeyConstraint)
    suppliersProducts.EnforceConstraints = True
End Sub

Comentários

Um ForeignKeyConstraint restringe a ação executada quando um valor em uma coluna (ou colunas) é excluído ou atualizado. Essa restrição destina-se a ser usada com colunas de chave primária. Em uma relação pai/filho entre duas tabelas, excluir um valor da tabela pai pode afetar as linhas filho de uma das seguintes maneiras.

• As linhas filho também podem ser excluídas (uma ação em cascata).

• Os valores na coluna filho (ou colunas) podem ser definidos como valores nulos.

• Os valores na coluna filho (ou colunas) podem ser definidos como valores padrão.

• Uma exceção pode ser gerada.

ForeignKeyConstraint os objetos estão contidos no ConstraintCollection de um DataTable, que é acessado por meio da Constraints propriedade .

As restrições não são impostas, a menos que a EnforceConstraints propriedade esteja definida como true.

O AcceptRejectRule é imposto sempre que o método de AcceptChanges um DataTable objeto é invocado.

Construtores

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[], 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[], 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.

Propriedades

_DataSet	Obtém o DataSet ao qual esta restrição pertence. (Herdado de Constraint)
AcceptRejectRule	Indica a ação que deve ocorrer por essa restrição quando AcceptChanges() é invocado.
Columns	Obtém as colunas filho dessa restrição.
ConstraintName	O nome de uma restrição no ConstraintCollection. (Herdado de Constraint)
DeleteRule	Obtém ou define a ação que ocorre nessa restrição quando uma linha é excluída.
ExtendedProperties	Obtém a coleção de propriedades de restrição definidas pelo usuário. (Herdado de Constraint)
RelatedColumns	As colunas pai dessa restrição.
RelatedTable	Obtém a tabela pai dessa restrição.
Table	Obtém a tabela filho dessa restrição.
UpdateRule	Obtém ou define a ação que ocorre nessa restrição quando uma linha é atualizada.

Métodos

CheckStateForProperty()	Obtém o DataSet ao qual esta restrição pertence. (Herdado de Constraint)
Equals(Object)	Obtém um valor que indica se o ForeignKeyConstraint atual é idêntico ao objeto especificado.
GetHashCode()	Obtém o código hash desta instância do objeto ForeignKeyConstraint.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
SetDataSet(DataSet)	Define o DataSet da restrição. (Herdado de Constraint)
ToString()	Obtém o ConstraintName, se houver um, como uma cadeia de caracteres. (Herdado de Constraint)

Acesso thread-safe

Este tipo é seguro para operações de leitura e multithread. Você deve sincronizar todas as operações de gravação.

Confira também

• AcceptRejectRule
• DataTable
• ConstraintCollection
• Rule