Restricciones de DataTable

Se pueden utilizar restricciones para exigir restricciones sobre los datos de un objeto DataTable con el fin de mantener la integridad de los datos. Una restricción es una regla automática que se aplica a una columna, o a varias columnas relacionadas, que determina cómo proceder cuando se modifica de alguna manera el valor de una fila. Las restricciones se exigen cuando la propiedad System.Data.DataSet.EnforceConstraints del DataSet es true. Para ver un ejemplo de código que muestre cómo establecer la propiedad EnforceConstraints, vea el tema de referencia EnforceConstraints.

Existen dos tipos de restricciones en ADO.NET: ForeignKeyConstraint y UniqueConstraint. De forma predeterminada, las dos restricciones se crean automáticamente al crear una relación entre dos o más tablas agregando DataRelation al DataSet. Sin embargo, se puede deshabilitar este comportamiento especificando createConstraints = false al crear la relación.

ForeignKeyConstraint

ForeignKeyConstraint exige reglas sobre cómo se propagan las actualizaciones y eliminaciones a las tablas relacionadas. Por ejemplo, si se actualiza o elimina el valor de una fila de una tabla y el mismo valor también se utiliza en una o varias tablas relacionadas, ForeignKeyConstraint determinará qué sucede en las tablas relacionadas.

Las propiedades DeleteRule y UpdateRule de ForeignKeyConstraint definen la acción que se ha de realizar cuando el usuario intente eliminar o actualizar una fila en una tabla relacionada. En la tabla siguiente se describen las distintas configuraciones disponibles para las propiedades DeleteRule y UpdateRule de ForeignKeyConstraint.

ForeignKeyConstraint puede restringir, además de propagar, los cambios en las columnas relacionadas. Dependiendo de las propiedades establecidas para la ForeignKeyConstraint de una columna, y si la propiedad EnforceConstraints del DataSet es true, realizar ciertas operaciones en la fila primaria generará una excepción. Por ejemplo, si la propiedad DeleteRule de ForeignKeyConstraint es None, una fila primaria no se puede eliminar si tiene filas secundarias.

Se puede crear una restricción de clave externa entre columnas individuales o entre una matriz de columnas utilizando el constructor ForeignKeyConstraint. Pase el objeto ForeignKeyConstraint resultante al método Add de la propiedad Constraints de la tabla, que es una ConstraintCollection. También puede pasar argumentos de constructor a varias sobrecargas del método Add de ConstraintCollection para crear una ForeignKeyConstraint.

Al crear una ForeignKeyConstraint, se pueden pasar los valores DeleteRule y UpdateRule al constructor como argumentos, o se pueden configurar como propiedades, como en el ejemplo siguiente (en que el valor DeleteRule se establece como None).

Dim custOrderFK As ForeignKeyConstraint = New ForeignKeyConstraint("CustOrderFK", _  
  custDS.Tables("CustTable").Columns("CustomerID"), _  
  custDS.Tables("OrdersTable").Columns("CustomerID"))  
custOrderFK.DeleteRule = Rule.None
' Cannot delete a customer value that has associated existing orders.  
custDS.Tables("OrdersTable").Constraints.Add(custOrderFK)  

ForeignKeyConstraint custOrderFK = new ForeignKeyConstraint("CustOrderFK",  
  custDS.Tables["CustTable"].Columns["CustomerID"],
  custDS.Tables["OrdersTable"].Columns["CustomerID"]);  
custOrderFK.DeleteRule = Rule.None;
// Cannot delete a customer value that has associated existing orders.  
custDS.Tables["OrdersTable"].Constraints.Add(custOrderFK);  

AcceptRejectRule

Los cambios realizados en filas se pueden aceptar con el método AcceptChanges o cancelar con el método RejectChanges de DataSet, DataTable o DataRow. Si un DataSet contiene ForeignKeyConstraints, al invocar los métodos AcceptChanges o RejectChanges se exige AcceptRejectRule. La propiedad AcceptRejectRule de ForeignKeyConstraint determina qué acción se tomará en las filas secundarias cuando se llame a AcceptChanges o RejectChanges en la fila primaria.

En la siguiente tabla se incluyen los valores disponibles para AcceptRejectRule.

Ejemplo

En el ejemplo siguiente se crea un ForeignKeyConstraint, se establecen varias de sus propiedades, incluida la AcceptRejectRule, y se añade a la ConstraintCollection de un objeto DataTable.

static void CreateConstraint(DataSet dataSet,
    string table1, string table2, string column1, string column2)
{
    // Declare parent column and child column variables.
    DataColumn parentColumn, childColumn;
    ForeignKeyConstraint foreignKeyConstraint;

    // Set parent and child column variables.
    parentColumn = dataSet.Tables[table1]?.Columns[column1] ??
        throw new NullReferenceException($"{nameof(CreateConstraint)}: {table1}.{column1} not found");
    childColumn = dataSet.Tables[table2]?.Columns[column2] ??
        throw new NullReferenceException($"{nameof(CreateConstraint)}: {table2}.{column2} not found");
    foreignKeyConstraint = new ForeignKeyConstraint
       ("SupplierForeignKeyConstraint", parentColumn, childColumn)
    {
        // Set null values when a value is deleted.
        DeleteRule = Rule.SetNull,
        UpdateRule = Rule.Cascade,
        AcceptRejectRule = AcceptRejectRule.None
    };

    // Add the constraint, and set EnforceConstraints to true.
    dataSet.Tables[table1]?.Constraints.Add(foreignKeyConstraint);
    dataSet.EnforceConstraints = true;
}

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

    ' Declare parent column and child column variables.
    Dim parentColumn As DataColumn
    Dim childColumn As DataColumn
    Dim foreignKeyConstraint As ForeignKeyConstraint

    ' Set parent and child column variables.
    parentColumn = dataSet.Tables(table1).Columns(column1)
    childColumn = dataSet.Tables(table2).Columns(column2)
    foreignKeyConstraint = New ForeignKeyConstraint _
       ("SupplierForeignKeyConstraint", parentColumn, childColumn)

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

    ' Add the constraint, and set EnforceConstraints to true.
    dataSet.Tables(table1).Constraints.Add(foreignKeyConstraint)
    dataSet.EnforceConstraints = True
End Sub

UniqueConstraint

El objeto UniqueConstraint, que se puede asignar a una sola columna o a una matriz de columnas de una DataTable, garantiza que todos los datos de las columnas especificadas son únicos en cada fila. Se puede crear una restricción única para una columna o matriz de columnas con el constructor UniqueConstraint. Pase el objeto UniqueConstraint resultante al método Add de la propiedad Constraints de la tabla, que es una ConstraintCollection. También puede pasar argumentos de constructor a varias sobrecargas del método Add de una ConstraintCollection para crear una UniqueConstraint. Al crear una UniqueConstraint para una columna o columnas, se puede especificar opcionalmente si la columna o columnas son una clave principal.

También se puede crear una restricción única para una sola columna estableciendo su propiedad Unique en true. Por otra parte, si se establece la propiedad Unique de una sola columna en false se quita cualquier restricción única que pudiera existir. Si se define una o varias columnas como clave principal de una tabla se creará automáticamente una restricción única para la columna o columnas especificadas. Si quita una columna mediante la propiedad PrimaryKey de una DataTable, se quita la UniqueConstraint.

En el ejemplo siguiente se crea una UniqueConstraint para dos columnas de una DataTable.

Dim custTable As DataTable = custDS.Tables("Customers")  
Dim custUnique As UniqueConstraint = _  
    New UniqueConstraint(New DataColumn()   {custTable.Columns("CustomerID"), _  
    custTable.Columns("CompanyName")})  
custDS.Tables("Customers").Constraints.Add(custUnique)  

DataTable custTable = custDS.Tables["Customers"];  
UniqueConstraint custUnique = new UniqueConstraint(new DataColumn[]
    {custTable.Columns["CustomerID"],
    custTable.Columns["CompanyName"]});  
custDS.Tables["Customers"].Constraints.Add(custUnique);  

Consulte también

• DataRelation
• DataTable
• ForeignKeyConstraint
• UniqueConstraint
• Definición del esquema de DataTable
• Objetos DataSet, DataTable y DataView
• Información general de ADO.NET