DataRelation (Clase)

El control DataRelation se utiliza para relacionar dos objetos DataTable entre sí a mediante objetos DataColumn. Por ejemplo, en una relación Customer/Orders, la tabla Customers es el elemento primario y la tabla Orders el secundario. Es similar a una relación entre la clave principal y la clave externa. Para obtener más información, vea Navegar por DataRelations (ADO.NET).

Las relaciones se crean entre columnas coincidentes de las tablas primarias y secundarias. Es decir, el valor DataType para ambas columnas debe ser idéntico.

Las relaciones también pueden originar varios cambios en cascada desde el DataRow primario hasta sus filas secundarias. Para controlar el cambio de valores en las filas secundarias, agregue un ForeignKeyConstraint al ConstraintCollection del objeto DataTable. ConstraintCollection determina la acción que se debe realizar cuando se elimina o actualiza un valor de una tabla primaria.

Cuando se crea un DataRelation, primero se comprueba que se puede establecer la relación. Después de agregarlo al DataRelationCollection, se mantiene la relación al no permitir ningún cambio que la invalide. Entre el período en que se crea un DataRelation y en que se agrega al DataRelationCollection, se pueden realizar cambios adicionales en las filas primarias o secundarias. Si esto produce una relación que ya no es válida, se genera una excepción.

Nota
Pueden dañarse los datos si se define una relación bidireccional entre dos tablas. Una relación bidireccional consta de dos objetos DataRelation que usan las mismas columnas, con las funciones primarias y secundarias intercambiadas. No se produce ninguna excepción al guardar los objetos DataRelation; no obstante, pueden dañarse los datos.

Los objetos DataRelation se incluyen en un DataRelationCollection, al que se puede obtener acceso mediante la propiedad Relations del DataSet; y las propiedades ChildRelations y ParentRelations del DataTable.

En el ejemplo siguiente se crea un nuevo DataRelation y se agrega al DataRelationCollection de un DataSet.

private void CreateRelation() 
{
    // Get the DataColumn objects from two DataTable objects 
    // in a DataSet. Code to get the DataSet not shown here.
    DataColumn parentColumn = 
        DataSet1.Tables["Customers"].Columns["CustID"];
    DataColumn childColumn = 
        DataSet1.Tables["Orders"].Columns["CustID"];
    // Create DataRelation.
    DataRelation relCustOrder;
    relCustOrder = new DataRelation("CustomersOrders", 
        parentColumn, childColumn);
    // Add the relation to the DataSet.
    DataSet1.Relations.Add(relCustOrder);
}

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

Este tipo es seguro para operaciones de lectura multiproceso. Debe sincronizar cualquier operación de escritura.

Referencia