XDocument クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
XML ドキュメントを表します。 XDocument オブジェクトのコンポーネントと使用方法については、「XDocument クラスの概要」を参照してください。
public ref class XDocument : System::Xml::Linq::XContainerpublic class XDocument : System.Xml.Linq.XContainertype XDocument = class
inherit XContainerPublic Class XDocument
Inherits XContainer- 継承
例
次の例では、ドキュメントを作成し、コメントと要素を追加します。 次に、クエリの結果を使用して別のドキュメントを作成します。
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)
この例を実行すると、次の出力が生成されます。
<!--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[]) |
指定したXDocumentとコンテンツを使用して、XDeclaration クラスの新しいインスタンスを初期化します。 |
| XDocument(XDocument) |
プロパティ
| 名前 | 説明 |
|---|---|
| BaseUri |
この XObjectのベース URI を取得します。 (継承元 XObject) |
| Declaration |
このドキュメントの XML 宣言を取得または設定します。 |
| Document | (継承元 XObject) |
| DocumentType |
このドキュメントのドキュメント型定義 (DTD) を取得します。 |
| FirstNode |
このノードの最初の子ノードを取得します。 (継承元 XContainer) |
| LastNode |
このノードの最後の子ノードを取得します。 (継承元 XContainer) |
| NextNode |
このノードの次の兄弟ノードを取得します。 (継承元 XNode) |
| NodeType |
このノードのノードの種類を取得します。 |
| Parent | (継承元 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) |
XmlReader パラメーターで指定されたオプションを使用して |
| 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, LoadOptions) |
指定したストリームを使用して新しい XDocument インスタンスを作成し、必要に応じて空白を保持し、ベース URI を設定し、行情報を保持します。 |
| Load(Stream) |
指定したストリームを使用して、新しい XDocument インスタンスを作成します。 |
| Load(String, LoadOptions) |
ファイルから新しい XDocument を作成し、必要に応じて空白を保持し、ベース URI を設定し、行情報を保持します。 |
| Load(String) |
ファイルから新しい XDocument を作成します。 |
| Load(TextReader, LoadOptions) |
XDocumentから新しいTextReaderを作成し、必要に応じて空白を保持し、ベース URI を設定し、行情報を保持します。 |
| Load(TextReader) |
XDocumentから新しいTextReaderを作成します。 |
| Load(XmlReader, LoadOptions) | |
| Load(XmlReader) | |
| LoadAsync(Stream, LoadOptions, CancellationToken) |
新しい XDocument を非同期に作成し、指定したストリームから基になる XML ツリーを初期化します。必要に応じて空白を保持します。 |
| LoadAsync(TextReader, LoadOptions, CancellationToken) |
新しい XDocument を作成し、指定した TextReader パラメーターを使用して基になる XML ツリーを初期化します。必要に応じて空白を保持します。 |
| LoadAsync(XmlReader, LoadOptions, CancellationToken) | |
| MemberwiseClone() |
現在の Objectの簡易コピーを作成します。 (継承元 Object) |
| Nodes() |
この要素またはドキュメントの子ノードのコレクションをドキュメントの順序で返します。 (継承元 XContainer) |
| NodesAfterSelf() |
ドキュメントの順序で、このノードの後にある兄弟ノードのコレクションを返します。 (継承元 XNode) |
| NodesBeforeSelf() |
ドキュメントの順序で、このノードの前にある兄弟ノードのコレクションを返します。 (継承元 XNode) |
| Parse(String, LoadOptions) |
文字列から新しい XDocument を作成し、必要に応じて空白を保持し、ベース URI を設定し、行情報を保持します。 |
| Parse(String) |
文字列から新しい XDocument を作成します。 |
| 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, SaveOptions) | |
| Save(Stream) | |
| Save(String, SaveOptions) |
この XDocument をファイルにシリアル化し、必要に応じて書式設定を無効にします。 |
| Save(String) |
この XDocument をファイルにシリアル化し、既存のファイルが存在する場合は上書きします。 |
| Save(TextWriter, SaveOptions) |
この XDocument を TextWriterにシリアル化し、必要に応じて書式設定を無効にします。 |
| Save(TextWriter) |
この XDocument を TextWriterにシリアル化します。 |
| Save(XmlWriter) | |
| SaveAsync(Stream, SaveOptions, CancellationToken) | |
| SaveAsync(TextWriter, SaveOptions, CancellationToken) |
この XDocument を TextWriterに書き込みます。 |
| SaveAsync(XmlWriter, CancellationToken) | |
| ToString() |
このノードのインデントされた XML を返します。 (継承元 XNode) |
| ToString(SaveOptions) |
必要に応じて書式設定を無効にして、このノードの XML を返します。 (継承元 XNode) |
| WriteTo(XmlWriter) |
このドキュメントを XmlWriterに書き込みます。 |
| WriteToAsync(XmlWriter, CancellationToken) |
この XDocument の基になる XML ツリーを、指定した XmlWriterに書き込みます。 |
イベント
| 名前 | 説明 |
|---|---|
| Changed |
この XObject またはその子孫のいずれかが変更されたときに発生します。 (継承元 XObject) |
| Changing |
この XObject またはその子孫のいずれかが変更されるときに発生します。 (継承元 XObject) |
明示的なインターフェイスの実装
| 名前 | 説明 |
|---|---|
| IXmlLineInfo.HasLineInfo() |
この XObject に行情報があるかどうかを示す値を取得します。 (継承元 XObject) |
| IXmlLineInfo.LineNumber |
基になる XmlReader この XObjectについて報告される行番号を取得します。 (継承元 XObject) |
| IXmlLineInfo.LinePosition |
基になる XmlReader この XObjectに対して報告される行位置を取得します。 (継承元 XObject) |
