DataTable.Constraints Propriedade

Definição

Espaço de Nomes:
System.Data
Assemblagem:
System.Data.dll
Assemblagem:
netstandard.dll

Obtém a coleção de restrições mantidas por esta tabela.

public:
 property System::Data::ConstraintCollection ^ Constraints { System::Data::ConstraintCollection ^ get(); };
[System.Data.DataSysDescription("DataTableConstraintsDescr")]
public System.Data.ConstraintCollection Constraints { get; }
public System.Data.ConstraintCollection Constraints { get; }
[<System.Data.DataSysDescription("DataTableConstraintsDescr")>]
member this.Constraints : System.Data.ConstraintCollection
member this.Constraints : System.Data.ConstraintCollection
Public ReadOnly Property Constraints As ConstraintCollection

Valor de Propriedade

ConstraintCollection

A ConstraintCollection que contém a coleção de Constraint objetos para a tabela. Uma coleção vazia é devolvida se não Constraint existirem objetos.

Atributos
DataSysDescriptionAttribute

Exemplos

O exemplo seguinte acrescenta a ForeignKeyConstraint à coleção de restrições.

private void CreateConstraint(DataSet dataSet,
    string table1, string table2, string column1, string column2)
{
    ForeignKeyConstraint idKeyRestraint = new
        ForeignKeyConstraint(dataSet.Tables[table1].Columns[column1],
        dataSet.Tables[table2].Columns[column2]);

    // Set null values when a value is deleted.
    idKeyRestraint.DeleteRule = Rule.SetNull;
    idKeyRestraint.UpdateRule = Rule.Cascade;

    // Set AcceptRejectRule to cascade changes.
    idKeyRestraint.AcceptRejectRule = AcceptRejectRule.Cascade;

    dataSet.Tables[table1].Constraints.Add(idKeyRestraint);
    dataSet.EnforceConstraints = true;
}

Private Sub CreateConstraint(dataSet As DataSet, _
    table1 As String, table2 As String, _
    column1 As String, column2 As String)

    Dim idKeyRestraint As ForeignKeyConstraint = _
        New ForeignKeyConstraint _
        (dataSet.Tables(table1).Columns(column1), _
        dataSet.Tables(table2).Columns(column2))

    ' Set null values when a value is deleted.
    idKeyRestraint.DeleteRule = Rule.SetNull
    idKeyRestraint.UpdateRule = Rule.Cascade

    ' Set AcceptRejectRule to cascade changes.
    idKeyRestraint.AcceptRejectRule = AcceptRejectRule.Cascade
    
    dataSet.Tables(table1).Constraints.Add(idKeyRestraint)
    dataSet.EnforceConstraints = True
End Sub

Observações

A ForeignKeyConstraint restringe a ação realizada quando um valor numa coluna (ou colunas) é eliminado ou atualizado. Tal restrição destina-se a ser usada com colunas de chave primárias. Numa relação pai/filho entre duas tabelas, eliminar um valor da tabela pai pode afetar as linhas filhas de uma das seguintes formas.

  • As linhas filhas também podem ser eliminadas (uma ação em cascata).

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

  • Os valores na coluna (ou colunas) filhos podem ser definidos para valores predefinidos.

  • Pode ser gerada uma exceção.

A UniqueConstraint torna-se ativo ao tentar definir um valor numa chave primária para um valor não único.

Aplica-se a

Ver também