Aggiunta di oggetti DataRelationAdding DataRelations

In un DataSet contenente più oggetti DataTable è possibile usare gli oggetti DataRelation per creare relazioni tra le tabelle, navigare tra di esse e restituire le righe padre o figlio da una tabella correlata.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.

Gli argomenti richiesti per creare un DataRelation sono un nome per il DataRelation viene creato e una matrice di uno o più DataColumn riferimenti alle colonne che fungono da padre e figlio colonne coinvolte nella relazione.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. Dopo aver creato un DataRelation, è possibile usare per navigare tra le tabelle e recuperare i valori.After you have created a DataRelation, you can use it to navigate between tables and to retrieve values.

Aggiunta di un DataRelation a un DataSet aggiunge, per impostazione predefinita, una UniqueConstraint alla tabella padre e un ForeignKeyConstraint alla tabella figlio.Adding a DataRelation to a DataSet adds, by default, a UniqueConstraint to the parent table and a ForeignKeyConstraint to the child table. Per altre informazioni su questi vincoli predefiniti, vedere vincoli DataTable.For more information about these default constraints, see DataTable Constraints.

L'esempio di codice seguente crea una DataRelation usando due DataTable gli oggetti in un DataSet.The following code example creates a DataRelation using two DataTable objects in a DataSet. Ciascuna DataTable contiene una colonna denominata CustID, che agisce come un collegamento tra i due DataTable oggetti.Each DataTable contains a column named CustID, which serves as a link between the two DataTable objects. Nell'esempio viene aggiunto un unico DataRelation per il relazioni raccolta del DataSet.The example adds a single DataRelation to the Relations collection of the DataSet. Nell'esempio il primo argomento specifica il nome del DataRelation creato.The first argument in the example specifies the name of the DataRelation being created. Il secondo argomento imposta l'elemento padre DataColumn e il terzo argomento imposta l'elemento figlio DataColumn.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"]);  

Oggetto DataRelation dispone anche di un Nested proprietà che, quando impostato su true, fa in modo che le righe dalla tabella figlio all'interno della riga associata nella tabella padre scrittura come elementi XML utilizzando WriteXml .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 . Per altre informazioni, vedere Uso di XML in un set di dati.For more information, see Using XML in a DataSet.

Vedere ancheSee also