LINQ to XML 軸の概要

XML ツリーを作成した後、または XML ドキュメントを XML ツリーに読み込んだ後は、クエリを実行して要素や属性を調べたり、その値を取得したりできます。 コレクションの取得には、軸メソッド ( とも呼ぶ) を使用します。 一部の軸は、XElement コレクションを返す、XDocument クラスおよび IEnumerable<T> クラスのメソッドです。 一部の軸は、Extensions クラスの拡張メソッドです。 拡張メソッドとして実装されている軸は、コレクションに対して機能し、コレクションを返します。

XElement クラスの概要」で説明しているように、XElement オブジェクトは単一の要素ノードを表します。 要素のコンテンツは、複合要素 (構造化コンテンツとも呼ばれる) または単純要素です。 単純要素は、空の場合と値を含む場合があります。 ノードに構造化コンテンツが含まれている場合、さまざまな軸メソッドを使用して子孫要素の列挙を取得できます。 最も一般的に使用される軸メソッドは、Elements および Descendants です。

コレクションを返す軸メソッド以外に、LINQ to XML クエリでよく使用されるメソッドが 2 つあります。 Element メソッドは、1 つの XElement を返します。 Attribute メソッドは、1 つの XAttribute を返します。

LINQ クエリは多くの用途において、ツリーを調べてデータを抽出し、それを変換する方法として最も強力です。 LINQ クエリは、IEnumerable<T> を実装するオブジェクトに対して機能します。LINQ to XML 軸が、XElement コレクションの IEnumerable<T>XAttribute コレクションの IEnumerable<T> を返します。 クエリを実行するには、これらのコレクションが必要です。

要素と属性のコレクションを取得する軸メソッドに加えて、ツリーを詳細に反復処理するための軸メソッドもあります。 たとえば、要素と属性を処理する代わりに、ツリーのノードを操作できます。 ノードは、要素や属性よりも細かい粒度レベルです。 ノードの操作時には、XML コメント、テキスト ノード、処理命令などを調べることができます。 この機能は、たとえば、文書を XML として保存できるワード プロセッサを作成する場合に重要です。 ただし、大多数の XML プログラマが主に扱うのは、要素、属性、およびその値です。

要素のコレクションを取得するメソッド

XElement で呼び出して要素のコレクションを返す XElement クラス (またはその基本クラス) のメソッドを、次にまとめて示します。

メソッド 説明
XNode.Ancestors この要素の祖先の IEnumerable<T>XElement を返します。 オーバーロードでは、指定された IEnumerable<T> を持つ祖先の XElementXName を返します。
XContainer.Descendants この要素の子孫の IEnumerable<T>XElement を返します。 オーバーロードでは、指定された IEnumerable<T> を持つ子孫の XElementXName を返します。
XContainer.Elements この要素の子要素の IEnumerable<T>XElement を返します。 オーバーロードでは、指定された IEnumerable<T> を持つ子要素の XElementXName を返します。
XNode.ElementsAfterSelf この要素の後にある要素の IEnumerable<T>XElement を返します。 オーバーロードでは、指定された IEnumerable<T> を持つ、この要素の後にある要素の XElementXName を返します。
XNode.ElementsBeforeSelf この要素の前にある要素の IEnumerable<T>XElement を返します。 オーバーロードでは、指定された IEnumerable<T> を持つ、この要素の前にある要素の XElementXName を返します。
XElement.AncestorsAndSelf この要素とその祖先の IEnumerable<T>XElement を返します。 オーバーロードでは、指定された IEnumerable<T> を持つ要素の XElementXName を返します。
XElement.DescendantsAndSelf この要素とその子孫の IEnumerable<T>XElement を返します。 オーバーロードでは、指定された IEnumerable<T> を持つ要素の XElementXName を返します。

1 つの要素を取得するメソッド

次のメソッドは、XElement オブジェクトから 1 つの子を取得します。

メソッド 説明
XContainer.Element 指定された XElement を持つ最初の子 XName オブジェクトを返します。

属性のコレクションを取得するメソッド

次のメソッドは、XElement オブジェクトから属性を取得します。

メソッド 説明
XElement.Attributes すべての属性の IEnumerable<T>XAttribute を返します。

1 つの属性を取得するメソッド

次のメソッドは、XElement オブジェクトから 1 つの属性を取得します。

メソッド 説明
XElement.Attribute 指定された XAttribute を持つ XName を返します。