Compartir a través de

Agregar objetos DataRelation

En un DataSet que contiene varios objetos DataTable, es posible utilizar objetos DataRelation para relacionar una tabla con otra, navegar por las tablas y devolver filas secundarias o primarias de una tabla relacionada.

Los argumentos necesarios para crear dataRelation son un nombre para dataRelation que se va a crear y una matriz de una o varias DataColumn referencias a las columnas que actúan como columnas primarias y secundarias de la relación. Después de crear una instancia de DataRelation, puede usarla para navegar entre tablas y recuperar valores.

Al agregar una DataRelation a una DataSet, se agrega de forma predeterminada una UniqueConstraint a la tabla primaria y una ForeignKeyConstraint a la tabla secundaria. Para obtener más información sobre estas restricciones predeterminadas, vea Restricciones de DataTable.

En el siguiente ejemplo de código se crea una DataRelation utilizando dos objetos DataTable en un DataSet. Cada DataTable contiene una columna denominada CustID, que actúa como un vínculo entre los dos DataTable objetos. En el ejemplo se agrega una única DataRelation a la colección Relations de DataSet. El primer argumento del ejemplo especifica el nombre de DataRelation que se va a crear. El segundo argumento establece el elemento DataColumn primario y el tercer argumento establece el elemento DataColumn secundario.

customerOrders.Relations.Add("CustOrders", _  
  customerOrders.Tables("Customers").Columns("CustID"), _  
  customerOrders.Tables("Orders").Columns("CustID"))  

customerOrders.Relations.Add("CustOrders",  
  customerOrders.Tables["Customers"].Columns["CustID"],  
  customerOrders.Tables["Orders"].Columns["CustID"]);

DataRelation también tiene una propiedad Anidada que, cuando se establece en true, hace que las filas de la tabla secundaria se anidarán dentro de la fila asociada de la tabla primaria cuando se escriben como elementos XML mediante WriteXml . Para obtener más información, vea Uso de XML en un conjunto de datos.

Consulte también