XDocument クラス

リファレンス

定義

名前空間:: System.Xml.Linq

アセンブリ:: System.Xml.XDocument.dll

アセンブリ:: System.Xml.Linq.dll

アセンブリ:: netstandard.dll

ソース:: XDocument.cs

ソース:: XDocument.cs

ソース:: XDocument.cs

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

XML ドキュメントを表します。 XDocument オブジェクトのコンポーネントと使用方法については、「XDocument クラスの概要」をご覧ください。

public ref class XDocument : System::Xml::Linq::XContainer

public class XDocument : System.Xml.Linq.XContainer

type XDocument = class
    inherit XContainer

Public Class XDocument
Inherits XContainer

継承: Object

XObject

XNode

XContainer
XDocument

例

次の例では、ドキュメントを作成し、コメントと要素を追加します。次に、クエリの結果を使用して別のドキュメントを作成します。

XDocument srcTree = new XDocument(
    new XComment("This is a comment"),
    new XElement("Root",
        new XElement("Child1", "data1"),
        new XElement("Child2", "data2"),
        new XElement("Child3", "data3"),
        new XElement("Child2", "data4"),
        new XElement("Info5", "info5"),
        new XElement("Info6", "info6"),
        new XElement("Info7", "info7"),
        new XElement("Info8", "info8")
    )
);

XDocument doc = new XDocument(
    new XComment("This is a comment"),
    new XElement("Root",
        from el in srcTree.Element("Root").Elements()
        where ((string)el).StartsWith("data")
        select el
    )
);
Console.WriteLine(doc);

Dim srcTree As XDocument = _
    <?xml version="1.0" encoding="utf-8" standalone="yes"?>
        <!--This is a comment-->
        <Root>
            <Child1>data1</Child1>
            <Child2>data2</Child2>
            <Child3>data3</Child3>
            <Child2>data4</Child2>
            <Info5>info5</Info5>
            <Info6>info6</Info6>
            <Info7>info7</Info7>
            <Info8>info8</Info8>
        </Root>
Dim doc As XDocument = _
    <?xml version="1.0" encoding="utf-8" standalone="yes"?>
        <!--This is a comment-->
        <Root>
            <%= From el In srcTree.<Root>.Elements _
                Where CStr(el).StartsWith("data") _
                Select el %>
        </Root>
Console.WriteLine(doc)

この例を実行すると、次の出力が生成されます。

XML

<!--This is a comment-->
<Root>
  <Child1>data1</Child1>
  <Child2>data2</Child2>
  <Child3>data3</Child3>
  <Child2>data4</Child2>
</Root>

注釈

の有効なコンテンツの XDocument詳細については、「 XElement オブジェクトと XDocument オブジェクトの有効なコンテンツ」を参照してください。

コンストラクター

XDocument()	XDocument クラスの新しいインスタンスを初期化します。
XDocument(Object[])	指定した内容で、XDocument クラスの新しいインスタンスを初期化します。
XDocument(XDeclaration, Object[])	指定した XDeclaration および内容を使用して、XDocument クラスの新しいインスタンスを初期化します。
XDocument(XDocument)	既存の XDocument オブジェクトから XDocument クラスの新しいインスタンスを初期化します。

プロパティ

BaseUri	この XObject のベース URI を取得します。 (継承元 XObject)
Declaration	このドキュメントの XML 宣言を取得または設定します。
Document	この XDocument の XObject を取得します。 (継承元 XObject)
DocumentType	このドキュメントのドキュメント型定義 (DTD: Document Type Definition) の名前を取得します。
FirstNode	このノードの最初の子ノードを取得します。 (継承元 XContainer)
LastNode	このノードの最後の子ノードを取得します。 (継承元 XContainer)
NextNode	このノードの次の兄弟ノードを取得します。 (継承元 XNode)
NodeType	このノードのノード型を取得します。
Parent	この XElement の親 XObject を取得します。 (継承元 XObject)
PreviousNode	このノードの前の兄弟ノードを取得します。 (継承元 XNode)
Root	このドキュメントの XML ツリーのルート要素を取得します。

メソッド

Add(Object)	指定した内容をこの XContainer の子として追加します。 (継承元 XContainer)
Add(Object[])	指定した内容をこの XContainer の子として追加します。 (継承元 XContainer)
AddAfterSelf(Object)	このノードの直後に指定された内容を追加します。 (継承元 XNode)
AddAfterSelf(Object[])	このノードの直後に指定された内容を追加します。 (継承元 XNode)
AddAnnotation(Object)	この XObject の注釈の一覧にオブジェクトを追加します。 (継承元 XObject)
AddBeforeSelf(Object)	指定した内容をこのノードの直前に追加します。 (継承元 XNode)
AddBeforeSelf(Object[])	指定した内容をこのノードの直前に追加します。 (継承元 XNode)
AddFirst(Object)	指定した内容をこのドキュメントまたは要素の最初の子として追加します。 (継承元 XContainer)
AddFirst(Object[])	指定した内容をこのドキュメントまたは要素の最初の子として追加します。 (継承元 XContainer)
Ancestors()	このノードの先祖要素のコレクションを返します。 (継承元 XNode)
Ancestors(XName)	このノードの先祖要素のフィルター処理されたコレクションを返します。一致する XName を持つ要素のみがコレクションに含められます。 (継承元 XNode)
Annotation(Type)	この XObject から指定した型の最初の注釈オブジェクトを取得します。 (継承元 XObject)
Annotation<T>()	この XObject から指定した型の最初の注釈オブジェクトを取得します。 (継承元 XObject)
Annotations(Type)	この XObject の指定した型の注釈のコレクションを取得します。 (継承元 XObject)
Annotations<T>()	この XObject の指定した型の注釈のコレクションを取得します。 (継承元 XObject)
CreateReader()	このノードの XmlReader を作成します。 (継承元 XNode)
CreateReader(ReaderOptions)	`readerOptions` パラメーターでオプションを指定して、XmlReader を作成します。 (継承元 XNode)
CreateWriter()	XmlWriter にノードを追加するために使用できる XContainer を作成します。 (継承元 XContainer)
DescendantNodes()	このドキュメントまたは要素の子孫ノードのコレクションをドキュメント順に返します。 (継承元 XContainer)
Descendants()	このドキュメントまたは要素の子孫要素のコレクションをドキュメント順に返します。 (継承元 XContainer)
Descendants(XName)	このドキュメントまたは要素の子孫要素のフィルター処理されたコレクションをドキュメント順に返します。一致する XName を持つ要素のみがコレクションに含められます。 (継承元 XContainer)
Element(XName)	指定した XName の最初の子要素を (ドキュメント順に) 取得します。 (継承元 XContainer)
Elements()	この要素またはドキュメントの子要素のコレクションをドキュメント順に返します。 (継承元 XContainer)
Elements(XName)	この要素またはドキュメントの子要素のフィルター処理されたコレクションをドキュメント順に返します。一致する XName を持つ要素のみがコレクションに含められます。 (継承元 XContainer)
ElementsAfterSelf()	このノードの後にある兄弟要素のコレクションをドキュメント順に返します。 (継承元 XNode)
ElementsAfterSelf(XName)	このノードの後にある兄弟要素のフィルター処理されたコレクションをドキュメント順に返します。一致する XName を持つ要素のみがコレクションに含められます。 (継承元 XNode)
ElementsBeforeSelf()	このノードの前にある兄弟要素のコレクションをドキュメント順に返します。 (継承元 XNode)
ElementsBeforeSelf(XName)	このノードの前にある兄弟要素のフィルター処理されたコレクションをドキュメント順に返します。一致する XName を持つ要素のみがコレクションに含められます。 (継承元 XNode)
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
IsAfter(XNode)	ドキュメント順に基づいて、現在のノードを指定したノードの後に表示するかどうかを決定します。 (継承元 XNode)
IsBefore(XNode)	ドキュメント順に基づいて、現在のノードを指定したノードの前に表示するかどうかを決定します。 (継承元 XNode)
Load(Stream)	指定されたストリームを使用して新しい XDocument インスタンスを作成します。
Load(Stream, LoadOptions)	指定されたストリームを使用して新しい XDocument インスタンスを作成し、必要に応じて、空白の維持、ベース URI の設定、および行情報の保持を行います。
Load(String)	ファイルから新しい XDocument を作成します。
Load(String, LoadOptions)	ファイルから新しい XDocument を作成し、必要に応じて、空白の維持、ベース URI の設定、および行情報の保持を行います。
Load(TextReader)	XDocument から新しい TextReader を作成します。
Load(TextReader, LoadOptions)	TextReader から新しい XDocument を作成し、必要に応じて、空白の維持、ベース URI の設定、および行情報の保持を行います。
Load(XmlReader)	XmlReader から新しいXDocument を作成します。
Load(XmlReader, LoadOptions)	XmlReader から XDocument を読み込み、必要に応じて、ベース URI の設定および行情報の保持を行います。
LoadAsync(Stream, LoadOptions, CancellationToken)	新しい XDocument を非同期に作成し、指定したストリームからその基になる XML ツリーを初期化します。必要に応じて、空白を維持します。
LoadAsync(TextReader, LoadOptions, CancellationToken)	新しい XDocument を作成し、指定した TextReader パラメーターを使用してその基になる XML ツリーを初期化します。必要に応じて、空白を維持します。
LoadAsync(XmlReader, LoadOptions, CancellationToken)	指定した XmlReader の内容を含む新しい XDocument を作成します。
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
Nodes()	この要素またはドキュメントの子ノードのコレクションをドキュメント順に返します。 (継承元 XContainer)
NodesAfterSelf()	このノードの後にある兄弟ノードのコレクションをドキュメント順に返します。 (継承元 XNode)
NodesBeforeSelf()	このノードの前にある兄弟ノードのコレクションをドキュメント順に返します。 (継承元 XNode)
Parse(String)	文字列から新しい XDocument を作成します。
Parse(String, LoadOptions)	文字列から新しい XDocument を作成し、必要に応じて、空白の維持、ベース URI の設定、および行情報の保持を行います。
Remove()	現在のノードを親から削除します。 (継承元 XNode)
RemoveAnnotations(Type)	この XObject から指定した型の注釈を削除します。 (継承元 XObject)
RemoveAnnotations<T>()	この XObject から指定した型の注釈を削除します。 (継承元 XObject)
RemoveNodes()	このドキュメントまたは要素から子ノードを削除します。 (継承元 XContainer)
ReplaceNodes(Object)	このドキュメントまたは要素の子ノードを指定された内容で置き換えます。 (継承元 XContainer)
ReplaceNodes(Object[])	このドキュメントまたは要素の子ノードを指定された内容で置き換えます。 (継承元 XContainer)
ReplaceWith(Object)	現在のノードを指定された内容に置き換えます。 (継承元 XNode)
ReplaceWith(Object[])	現在のノードを指定された内容に置き換えます。 (継承元 XNode)
Save(Stream)	この XDocument を指定した Stream に出力します。
Save(Stream, SaveOptions)	オプションで書式設定動作を指定して、この XDocument を指定した Stream に出力します。
Save(String)	この XDocument をシリアル化してファイルに書き込み、既存のファイルを上書きします (存在する場合)。
Save(String, SaveOptions)	この XDocument をシリアル化してファイルに書き込み、必要に応じて、書式設定を無効にします。
Save(TextWriter)	この XDocument をシリアル化して TextWriter に書き込みます。
Save(TextWriter, SaveOptions)	この XDocument をシリアル化して TextWriter に書き込み、必要に応じて、書式設定を無効にします。
Save(XmlWriter)	この XDocument をシリアル化して XmlWriter に書き込みます。
SaveAsync(Stream, SaveOptions, CancellationToken)	この XDocument を Stream に出力します。
SaveAsync(TextWriter, SaveOptions, CancellationToken)	この XDocument を TextWriter に書き込みます。
SaveAsync(XmlWriter, CancellationToken)	この XDocument を XmlWriter に書き込みます。
ToString()	このノードに対してインデントが設定された XML を返します。 (継承元 XNode)
ToString(SaveOptions)	このノードに対して XML を返し、オプションで書式設定を無効にします。 (継承元 XNode)
WriteTo(XmlWriter)	このドキュメントを XmlWriter に書き込みます。
WriteToAsync(XmlWriter, CancellationToken)	この XDocument の基になる XML ツリーを指定した XmlWriter に書き込みます。
WriteToAsync(XmlWriter, CancellationToken)	現在のノードを XmlWriter に書き込みます。 (継承元 XNode)

イベント

Changed	この XObject またはその子孫が変更されたときに発生します。 (継承元 XObject)
Changing	この XObject またはその子孫が変更される直前に発生します。 (継承元 XObject)

明示的なインターフェイスの実装

IXmlLineInfo.HasLineInfo()	この XObject に行情報があるかどうかを示す値を取得します。 (継承元 XObject)
IXmlLineInfo.LineNumber	基になる XmlReader がこの XObject について報告した行番号を取得します。 (継承元 XObject)
IXmlLineInfo.LinePosition	基になる XmlReader がこの XObject について報告した行番号を取得します。 (継承元 XObject)

拡張メソッド

Validate(XDocument, XmlSchemaSet, ValidationEventHandler)	このメソッドは、XDocument が XmlSchemaSet の XSD に準拠しているかどうかを検証します。
Validate(XDocument, XmlSchemaSet, ValidationEventHandler, Boolean)	XDocument が XmlSchemaSet の XSD に準拠しているかどうかを検証します。オプションで、スキーマ検証後の infoset (PSVI) を XML ツリーに設定できます。
CreateNavigator(XNode)	XPathNavigator の XNode を作成します。
CreateNavigator(XNode, XmlNameTable)	XPathNavigator の XNode を作成します。 XmlNameTable を使用すると、XPath 式をより効率的に処理できます。
XPathEvaluate(XNode, String)	XPath 式を評価します。
XPathEvaluate(XNode, String, IXmlNamespaceResolver)	XPath 式を評価します。このとき、指定された IXmlNamespaceResolver を使用して名前空間プレフィックスを解決します。
XPathSelectElement(XNode, String)	XPath 式を使用して XElement を選択します。
XPathSelectElement(XNode, String, IXmlNamespaceResolver)	XPath 式を使用して XElement を選択します。このとき、指定された IXmlNamespaceResolver を使用して名前空間プレフィックスを解決します。
XPathSelectElements(XNode, String)	XPath 式を使用して要素のコレクションを選択します。
XPathSelectElements(XNode, String, IXmlNamespaceResolver)	XPath 式を使用して要素のコレクションを選択します。このとき、指定された IXmlNamespaceResolver を使用して名前空間プレフィックスを解決します。
ToXPathNavigable(XNode)	指定した XNode に移動して編集できるアクセサーを返します。

適用対象

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

AI Skills Fest

次の方法で共有