Agregar objetos DataRelationAdding DataRelations

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.In a DataSet with multiple DataTable objects, you can use DataRelation objects to relate one table to another, to navigate through the tables, and to return child or parent rows from a related table.

Los argumentos necesarios para crear una DataRelation son un nombre para la 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.The arguments required to create a DataRelation are a name for the DataRelation being created, and an array of one or more DataColumn references to the columns that serve as the parent and child columns in the relationship. Después de crear una DataRelation, puede usarla para desplazarse entre las tablas y recuperar los valores.After you have created a DataRelation, you can use it to navigate between tables and to retrieve values.

Agregar una DataRelation a DataSet agrega, UniqueConstraint de forma predeterminada, a la tabla primaria y ForeignKeyConstraint a la tabla secundaria.Adding a DataRelation to a DataSet adds, by default, a UniqueConstraint to the parent table and a ForeignKeyConstraint to the child table. Para obtener más información sobre estas restricciones predeterminadas, consulte restricciones de DataTable.For more information about these default constraints, see DataTable Constraints.

En el ejemplo de código siguiente se crea una DataRelation DataTable con dos objetos DataSeten un.The following code example creates a DataRelation using two DataTable objects in a DataSet. Cada DataTable contiene una columna denominada CustID, que actúa como un vínculo entre los dos DataTable objetos.Each DataTable contains a column named CustID, which serves as a link between the two DataTable objects. En el ejemplo se agrega una única DataRelation a la DataSetcolección Relations de.The example adds a single DataRelation to the Relations collection of the DataSet. El primer argumento del ejemplo especifica el nombre de la DataRelation que se va a crear.The first argument in the example specifies the name of the DataRelation being created. El segundo argumento establece la DataColumn primaria y el tercer argumento establece la DataColumnsecundaria.The second argument sets the parent DataColumn and the third argument sets the child DataColumn.

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"]);  

Una DataRelation también tiene una propiedad anidada que, cuando se establece en true, hace que las filas de la tabla secundaria se aniden dentro de la fila asociada de la tabla primaria cuando se escriben como elementos WriteXml XML mediante.A DataRelation also has a Nested property which, when set to true, causes the rows from the child table to be nested within the associated row from the parent table when written as XML elements using WriteXml . Para obtener más información, vea Using XML in a DataSet (Usar XML en un conjunto de datos).For more information, see Using XML in a DataSet.

Vea tambiénSee also