Adicionando DataRelations

Em um DataSet com vários DataTable objetos, você pode usar DataRelation objetos para relacionar uma tabela a outra, navegar pelas tabelas e retornar linhas filho ou pai de uma tabela relacionada.

Os argumentos necessários para criar um DataRelation são um nome do DataRelation a ser criado e uma matriz de uma ou mais referências DataColumn às colunas que servem como colunas pai e filho na relação. Depois de criar um DataRelation, você pode usá-lo para navegar entre tabelas e recuperar valores.

Adicionar um DataRelation a um DataSet adiciona, por defeito, um UniqueConstraint à tabela pai e um ForeignKeyConstraint à tabela filha. Para obter mais informações sobre essas restrições padrão, consulte Restrições de DataTable.

O exemplo de código seguinte cria um DataRelation usando dois DataTable objetos num DataSet. Cada DataTable um contém uma coluna chamada CustID, que serve como um link entre os dois DataTable objetos. O exemplo acrescenta um único DataRelation à coleção Relations do DataSet. O primeiro argumento no exemplo especifica o nome do DataRelation que está a ser criado. O segundo argumento define o pai DataColumn e o terceiro argumento define a filha 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"]);

A DataRelation também tem uma propriedade Nested que, quando definida como verdadeira, faz com que as linhas da tabela filha fiquem aninhadas dentro da linha associada da tabela pai ao serem escritas como elementos XML usando WriteXml. Para obter mais informações, consulte Usando XML em um DataSet.

Ver também

• DataSets, DataTables e DataViews
• Visão geral ADO.NET