DataTable.Constraints DataTable.Constraints DataTable.Constraints DataTable.Constraints Property

Definición

Obtiene la colección de restricciones mantenidas por esta tabla.Gets the collection of constraints maintained by this table.

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

Valor de propiedad

Objeto ConstraintCollection que contiene la colección de objetos Constraint para la tabla.A ConstraintCollection that contains the collection of Constraint objects for the table. Si no existe ningún objeto Constraint, se devuelve una colección vacía.An empty collection is returned if no Constraint objects exist.

Ejemplos

En el ejemplo siguiente se agrega un ForeignKeyConstraint a la colección de restricciones.The following example adds a ForeignKeyConstraint to the collection of constraints.

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

Un ForeignKeyConstraint restringe la acción realizada cuando se elimina o actualiza un valor en una columna (o columnas).A ForeignKeyConstraint restricts the action performed when a value in a column (or columns) is either deleted or updated. Este tipo de restricción está pensado para utilizarse con columnas de clave principal.Such a constraint is intended to be used with primary key columns. En una relación primaria-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.In a parent/child relationship between two tables, deleting a value from the parent table can affect the child rows in one of the following ways.

  • El elemento secundario filas también se pueden elimina (una acción en cascada).The child rows can also be deleted (a cascading action).

  • Los valores de la columna secundaria (o columnas) se pueden establecer en valores nulos.The values in the child column (or columns) can be set to null values.

  • Los valores de la columna secundaria (o columnas) se pueden establecer en valores predeterminados.The values in the child column (or columns) can be set to default values.

  • Se puede generar una excepción.An exception can be generated.

Un UniqueConstraint se convierte en activa cuando se intenta establecer un valor en una clave principal a un valor que no es único.A UniqueConstraint becomes active when attempting to set a value in a primary key to a non-unique value.

Se aplica a

Consulte también: