DataTable.Constraints Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Data
Ensamblado:
System.Data.Common.dll
Ensamblado:
System.Data.dll
Ensamblado:
netstandard.dll
Source:
DataTable.cs
Source:
DataTable.cs
Source:
DataTable.cs

Obtiene la colección de restricciones mantenidas por esta tabla.

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

Valor de propiedad

ConstraintCollection

Objeto ConstraintCollection que contiene la colección de objetos Constraint para la tabla. Si no existe ningún objeto Constraint, se devuelve una colección vacía.

Atributos
DataSysDescriptionAttribute

Ejemplos

En el ejemplo siguiente se agrega un ForeignKeyConstraint objeto a la colección de restricciones .

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

Comentarios

Restringe ForeignKeyConstraint la acción realizada cuando se elimina o actualiza un valor de una columna (o columnas). Esta restricción está pensada para usarse con columnas de clave principal. En una relación primaria o secundaria entre dos tablas, la eliminación de un valor de la tabla primaria puede afectar a las filas secundarias de una de las maneras siguientes.

  • Las filas secundarias también se pueden eliminar (una acción en cascada).

  • Los valores de la columna secundaria (o columnas) se pueden establecer en valores NULL.

  • Los valores de la columna secundaria (o columnas) se pueden establecer en valores predeterminados.

  • Se puede generar una excepción.

Se UniqueConstraint activa al intentar establecer un valor en una clave principal en un valor no único.

Se aplica a

Consulte también