DataRelation Clase

Definición

public ref class DataRelation

[System.ComponentModel.TypeConverter(typeof(System.Data.RelationshipConverter))]
public class DataRelation

public class DataRelation

[System.ComponentModel.TypeConverter(typeof(System.Data.RelationshipConverter))]
[System.Serializable]
public class DataRelation

[<System.ComponentModel.TypeConverter(typeof(System.Data.RelationshipConverter))>]
type DataRelation = class

type DataRelation = class

[<System.ComponentModel.TypeConverter(typeof(System.Data.RelationshipConverter))>]
[<System.Serializable>]
type DataRelation = class

Public Class DataRelation

Herencia

Object

DataRelation

Atributos

TypeConverterAttribute SerializableAttribute

Ejemplos

En el ejemplo siguiente se crea un nuevo DataRelation objeto y se agrega a DataRelationCollection de .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);
}

Private Sub CreateRelation()
    ' Get the DataColumn objects from two DataTable objects 
    ' in a DataSet. Code to get the DataSet not shown here.
    Dim parentColumn As DataColumn = _
        DataSet1.Tables("Customers").Columns("CustID")
    Dim childColumn As DataColumn = DataSet1.Tables( _
        "Orders").Columns("CustID")

    ' Create DataRelation.
    Dim relCustOrder As DataRelation
    relCustOrder = New DataRelation( _
        "CustomersOrders", parentColumn, childColumn)

    ' Add the relation to the DataSet.
    DataSet1.Relations.Add(relCustOrder)
End Sub

Comentarios

DataRelation Se usa para relacionar dos DataTable objetos entre sí a través de DataColumn objetos . Por ejemplo, en una relación Customer/Orders, la tabla Customers es el elemento primario y la tabla Orders es el elemento secundario de la relación. Esto es similar a una relación de clave principal/clave externa. Para obtener más información, vea Navegar por DataRelations.

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

Las relaciones también pueden poner en cascada varios cambios del elemento primario DataRow a sus filas secundarias. Para controlar cómo se cambian los valores en las filas secundarias, agregue a ForeignKeyConstraint del ConstraintCollection DataTable objeto . ConstraintCollection determina qué acción realizar cuando se elimina o actualiza un valor de una tabla primaria.

Cuando se crea un DataRelation objeto , comprueba primero que se puede establecer la relación. Después de agregarlo a DataRelationCollection, la relación se mantiene al no permitir los cambios que la invaliden. Entre el período en DataRelation el que se crea y se agrega a DataRelationCollection, es posible realizar cambios adicionales en las filas primarias o secundarias. Se genera una excepción si esto provoca una relación que ya no es válida.

DataRelation Los objetos están contenidos en un DataRelationCollection, al que se puede tener acceso a través de la Relations propiedad de DataSet, y las ChildRelations propiedades y ParentRelations de DataTable.

Constructores

Propiedades

Métodos

Se aplica a

Seguridad para subprocesos

Este tipo es seguro para las operaciones de lectura multiproceso. Debe sincronizar las operaciones de escritura.

Consulte también

• ChildRelations
• DataColumn
• DataSet
• ForeignKeyConstraint
• DataRelationCollection
• UniqueConstraint
• ParentRelations