DataRelation の入れ子化

[アーティクル]
05/10/2023

データのリレーショナル表現では、各テーブルに含まれている行が、列または列セットを使用して相互に関連付けられています。 ADO.NET の DataSet では、テーブル間のリレーションシップは DataRelation を使用して実装されます。 DataRelation を作成すると、列の親子リレーションシップはこのリレーションだけをとおして管理されます。テーブルと列はそれぞれ別個のエンティティです。 XML のデータ階層表現では、子要素が入れ子の状態で含まれている親要素によって親子のリレーションシップが表現されます。

DataSet が XmlDataDocument と同期されているとき、または WriteXml を使用して XML データとして書き込まれるときに、子オブジェクトの入れ子を容易にするため、DataRelation では Nested プロパティが公開されています。 DataRelation の Nested プロパティを true に設定すると、XML データとして書き込まれるとき、または XmlDataDocument と同期されるときに、リレーションの子の行が親の列に入れ子にされます。 DataRelation の Nested プロパティは、既定では false に設定されます。

たとえば、次のような DataSet があるとします。

' Assumes connection is a valid SqlConnection.  
Dim customerAdapter As SqlDataAdapter = New SqlDataAdapter( _  
  "SELECT CustomerID, CompanyName FROM Customers", connection)  
Dim orderAdapter As SqlDataAdapter = New SqlDataAdapter( _  
  "SELECT OrderID, CustomerID, OrderDate FROM Orders", connection)  
  
connection.Open()  
  
Dim dataSet As DataSet = New DataSet("CustomerOrders")  
customerAdapter.Fill(dataSet, "Customers")  
orderAdapter.Fill(dataSet, "Orders")  
  
connection.Close()  
  
Dim customerOrders As DataRelation = dataSet.Relations.Add( _  
  "CustOrders", dataSet.Tables("Customers").Columns("CustomerID"), _  
  dataSet.Tables("Orders").Columns("CustomerID"))

// Assumes connection is a valid SqlConnection.  
SqlDataAdapter customerAdapter = new SqlDataAdapter(  
  "SELECT CustomerID, CompanyName FROM Customers", connection);  
SqlDataAdapter orderAdapter = new SqlDataAdapter(  
  "SELECT OrderID, CustomerID, OrderDate FROM Orders", connection);  
  
connection.Open();  
  
DataSet dataSet = new DataSet("CustomerOrders");  
customerAdapter.Fill(dataSet, "Customers");  
orderAdapter.Fill(dataSet, "Orders");  
  
connection.Close();  
  
DataRelation customerOrders = dataSet.Relations.Add(  
  "CustOrders", dataSet.Tables["Customers"].Columns["CustomerID"],  
  dataSet.Tables["Orders"].Columns["CustomerID"]);

この DataSet では DataRelation オブジェクトの Nested プロパティが true に設定されていないため、この DataSet が XML データとして表されるときに、子オブジェクトは親要素内に入れ子にされません。データリレーションが入れ子になっていない関連 DataSet が含まれる DataSet の XML 表現を変換すると、パフォーマンスが低下する場合があります。データリレーションシップは入れ子にすることをお勧めします。そのためには、Nested プロパティを true に設定します。次に、トップダウン階層形式の XPath クエリ式を使用してデータを検索、変換するコードを XSLT スタイルシートに記述します。

次のコード例では、DataSet に対して WriteXml を呼び出した結果を示します。

<CustomerOrders>  
  <Customers>  
    <CustomerID>ALFKI</CustomerID>  
    <CompanyName>Alfreds Futterkiste</CompanyName>  
  </Customers>  
  <Customers>  
    <CustomerID>ANATR</CustomerID>  
    <CompanyName>Ana Trujillo Emparedados y helados</CompanyName>  
  </Customers>  
  <Orders>  
    <OrderID>10643</OrderID>  
    <CustomerID>ALFKI</CustomerID>  
    <OrderDate>1997-08-25T00:00:00</OrderDate>  
  </Orders>  
  <Orders>  
    <OrderID>10692</OrderID>  
    <CustomerID>ALFKI</CustomerID>  
    <OrderDate>1997-10-03T00:00:00</OrderDate>  
  </Orders>  
  <Orders>  
    <OrderID>10308</OrderID>  
    <CustomerID>ANATR</CustomerID>  
    <OrderDate>1996-09-18T00:00:00</OrderDate>  
  </Orders>  
</CustomerOrders>

Customers 要素と Orders 要素が兄弟要素として示されていることに注意してください。 Orders 要素が該当する親要素の子として示されるようにするには、DataRelation の Nested プロパティを true に設定する必要があり、次のコードを追加します。

customerOrders.Nested = True

customerOrders.Nested = true;

上記のコードを追加した結果の出力を次のコードに示します。この例では、Orders 要素がそれぞれ該当する親要素の中で入れ子になっています。

<CustomerOrders>  
  <Customers>  
    <CustomerID>ALFKI</CustomerID>  
    <Orders>  
      <OrderID>10643</OrderID>  
      <CustomerID>ALFKI</CustomerID>  
      <OrderDate>1997-08-25T00:00:00</OrderDate>  
    </Orders>  
    <Orders>  
      <OrderID>10692</OrderID>  
      <CustomerID>ALFKI</CustomerID>  
      <OrderDate>1997-10-03T00:00:00</OrderDate>  
    </Orders>  
    <CompanyName>Alfreds Futterkiste</CompanyName>  
  </Customers>  
  <Customers>  
    <CustomerID>ANATR</CustomerID>  
    <Orders>  
      <OrderID>10308</OrderID>  
      <CustomerID>ANATR</CustomerID>  
      <OrderDate>1996-09-18T00:00:00</OrderDate>  
    </Orders>  
    <CompanyName>Ana Trujillo Emparedados y helados</CompanyName>  
  </Customers>  
</CustomerOrders>

次の方法で共有

DataRelation の入れ子化

関連項目

その他のリソース