XElement クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
XML 要素を表します。 使用法の情報と例については、「XElement クラスの概要」およびこのページの「解説」セクションを参照してください。
public ref class XElement : System::Xml::Linq::XContainer, System::Xml::Serialization::IXmlSerializablepublic ref class XElement : System::Xml::Linq::XContainerpublic class XElement : System.Xml.Linq.XContainer, System.Xml.Serialization.IXmlSerializablepublic class XElement : System.Xml.Linq.XContainertype XElement = class
inherit XContainer
interface IXmlSerializabletype XElement = class
inherit XContainerPublic Class XElement
Inherits XContainer
Implements IXmlSerializablePublic Class XElement
Inherits XContainer- 継承
- 実装
例
次の例では、XML ツリーを作成します。 新しい要素の内容は、LINQ クエリから取得されます。
XElement xmlTree1 = new XElement("Root",
new XElement("Child1", 1),
new XElement("Child2", 2),
new XElement("Child3", 3),
new XElement("Child4", 4),
new XElement("Child5", 5),
new XElement("Child6", 6)
);
XElement xmlTree2 = new XElement("Root",
from el in xmlTree1.Elements()
where((int)el >= 3 && (int)el <= 5)
select el
);
Console.WriteLine(xmlTree2);
Dim xmlTree1 As XElement = _
<Root>
<Child1>1</Child1>
<Child2>2</Child2>
<Child3>3</Child3>
<Child4>4</Child4>
<Child5>5</Child5>
<Child6>6</Child6>
</Root>
Dim xmlTree2 As XElement = _
<Root>
<%= From el In xmlTree1.Elements() _
Where el.Value >= 3 And el.Value <= 5 _
Select el %>
</Root>
Console.WriteLine(xmlTree2)
この例を実行すると、次の出力が生成されます。
<Root>
<Child3>3</Child3>
<Child4>4</Child4>
<Child5>5</Child5>
</Root>
同じ例を次に示しますが、この場合、XML は名前空間にあります。 詳細については、「 XML 名前空間の操作」を参照してください。
XNamespace aw = "http://www.adventure-works.com";
XElement xmlTree1 = new XElement(aw + "Root",
new XElement(aw + "Child1", 1),
new XElement(aw + "Child2", 2),
new XElement(aw + "Child3", 3),
new XElement(aw + "Child4", 4),
new XElement(aw + "Child5", 5),
new XElement(aw + "Child6", 6)
);
XElement xmlTree2 = new XElement(aw + "Root",
from el in xmlTree1.Elements()
where((int)el >= 3 && (int)el <= 5)
select el
);
Console.WriteLine(xmlTree2);
Imports <xmlns="http://www.adventure-works.com">
Module Module1
Sub Main()
Dim xmlTree1 As XElement = _
<Root>
<Child1>1</Child1>
<Child2>2</Child2>
<Child3>3</Child3>
<Child4>4</Child4>
<Child5>5</Child5>
<Child6>6</Child6>
</Root>
Dim xmlTree2 As XElement = _
<Root>
<%= From el In xmlTree1.Elements() _
Where el.Value >= 3 And el.Value <= 5 _
Select el %>
</Root>
Console.WriteLine(xmlTree2)
End SUb
End Module
この例を実行すると、次の出力が生成されます。
<Root xmlns="http://www.adventure-works.com">
<Child3>3</Child3>
<Child4>4</Child4>
<Child5>5</Child5>
</Root>
注釈
このクラスは、基本的な XML コンストラクトである XML 要素を表します。 その他の使用方法については、「 XElement クラスの概要 」を参照してください。
要素には XName、必要に応じて 1 つ以上の属性があり、必要に応じてコンテンツを含めることができます (詳細については、「」を参照してください Nodes)。
には XElement 、次の種類のコンテンツを含めることができます。
の有効なコンテンツの XElement詳細については、「 XElement オブジェクトと XDocument オブジェクトの有効なコンテンツ」を参照してください。
XElement は から XContainer派生します。これは から XNode派生します。
一部 XElement のメソッドは XAML から使用できます。 詳細については、「LINQ to XML の動的プロパティ」を参照してください。
コンストラクター
| XElement(XElement) | |
| XElement(XName) |
指定した名前を使用して、XElement クラスの新しいインスタンスを初期化します。 |
| XElement(XName, Object) |
指定した名前と内容を持つ XElement クラスの新しいインスタンスを初期化します。 |
| XElement(XName, Object[]) |
指定した名前と内容を持つ XElement クラスの新しいインスタンスを初期化します。 |
| XElement(XStreamingElement) |
XElement オブジェクトから XStreamingElement クラスの新しいインスタンスを初期化します。 |
プロパティ
| BaseUri |
この XObject のベース URI を取得します。 (継承元 XObject) |
| Document |
この XDocument の XObject を取得します。 (継承元 XObject) |
| EmptySequence |
要素の空のコレクションを取得します。 |
| FirstAttribute |
この要素の最初の属性を取得します。 |
| FirstNode |
このノードの最初の子ノードを取得します。 (継承元 XContainer) |
| HasAttributes |
この要素が 1 つ以上の属性を持っているかどうかを示す値を取得します。 |
| HasElements |
この要素が 1 つ以上の子要素を持っているかどうかを示す値を取得します。 |
| IsEmpty |
この要素に内容が格納されていないかどうかを示す値を取得します。 |
| LastAttribute |
この要素の最後の属性を取得します。 |
| LastNode |
このノードの最後の子ノードを取得します。 (継承元 XContainer) |
| Name |
この要素の名前を取得または設定します。 |
| NextNode |
このノードの次の兄弟ノードを取得します。 (継承元 XNode) |
| NodeType |
このノードのノード型を取得します。 |
| Parent |
この XElement の親 XObject を取得します。 (継承元 XObject) |
| PreviousNode |
このノードの前の兄弟ノードを取得します。 (継承元 XNode) |
| Value |
この要素の連結されたテキスト コンテンツを取得または設定します。 |
メソッド
| 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) |
| AncestorsAndSelf() |
この要素およびこの要素の先祖を格納している、要素のコレクションを返します。 |
| AncestorsAndSelf(XName) |
この要素およびこの要素の先祖を格納している、フィルター処理された要素のコレクションを返します。 一致する XName を持つ要素のみがコレクションに含められます。 |
| Annotation(Type) |
この XObject から指定した型の最初の注釈オブジェクトを取得します。 (継承元 XObject) |
| Annotation<T>() |
この XObject から指定した型の最初の注釈オブジェクトを取得します。 (継承元 XObject) |
| Annotations(Type) |
この XObject の指定した型の注釈のコレクションを取得します。 (継承元 XObject) |
| Annotations<T>() |
この XObject の指定した型の注釈のコレクションを取得します。 (継承元 XObject) |
| Attribute(XName) |
指定した XName を持つ、この XElement の XAttribute を返します。 |
| Attributes() |
この要素の属性のコレクションを返します。 |
| Attributes(XName) |
この要素の属性のフィルター処理されたコレクションを返します。 一致する XName を持つ属性のみがコレクションに含められます。 |
| CreateReader() |
このノードの XmlReader を作成します。 (継承元 XNode) |
| CreateReader(ReaderOptions) |
|
| CreateWriter() |
XmlWriter にノードを追加するために使用できる XContainer を作成します。 (継承元 XContainer) |
| DescendantNodes() |
このドキュメントまたは要素の子孫ノードのコレクションをドキュメント順に返します。 (継承元 XContainer) |
| DescendantNodesAndSelf() |
この要素およびこの要素のすべての子孫ノードをドキュメント順で格納している、ノードのコレクションを返します。 |
| Descendants() |
このドキュメントまたは要素の子孫要素のコレクションをドキュメント順に返します。 (継承元 XContainer) |
| Descendants(XName) |
このドキュメントまたは要素の子孫要素のフィルター処理されたコレクションをドキュメント順に返します。 一致する XName を持つ要素のみがコレクションに含められます。 (継承元 XContainer) |
| DescendantsAndSelf() |
この要素およびこの要素のすべての子孫要素をドキュメント順で格納している、要素のコレクションを返します。 |
| DescendantsAndSelf(XName) |
この要素およびこの要素のすべての子孫要素をドキュメント順で格納している、フィルター処理された要素のコレクションを返します。 一致する XName を持つ要素のみがコレクションに含められます。 |
| 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) |
| GetDefaultNamespace() |
この XElement の既定の XNamespace を取得します。 |
| GetHashCode() |
既定のハッシュ関数として機能します。 (継承元 Object) |
| GetNamespaceOfPrefix(String) |
この XElement のプレフィックスに関連付けられた名前空間を取得します。 |
| GetPrefixOfNamespace(XNamespace) |
この XElement の名前空間に関連付けられているプレフィックスを取得します。 |
| GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
| IsAfter(XNode) |
ドキュメント順に基づいて、現在のノードを指定したノードの後に表示するかどうかを決定します。 (継承元 XNode) |
| IsBefore(XNode) |
ドキュメント順に基づいて、現在のノードを指定したノードの前に表示するかどうかを決定します。 (継承元 XNode) |
| Load(Stream) |
指定されたストリームを使用して新しい XElement インスタンスを作成します。 |
| Load(Stream, LoadOptions) |
指定されたストリームを使用して新しい XElement インスタンスを作成し、必要に応じて、空白の維持、ベース URI の設定、および行情報の保持を行います。 |
| Load(String) |
ファイルから XElement を読み込みます。 |
| Load(String, LoadOptions) |
ファイルから XElement を読み込み、必要に応じて、空白の維持、ベース URI の設定、および行情報の保持を行います。 |
| Load(TextReader) |
TextReader から XElement を読み込みます。 |
| Load(TextReader, LoadOptions) |
TextReader から XElement を読み込み、オプションで、空白の維持および行情報の保持を行います。 |
| Load(XmlReader) | |
| Load(XmlReader, LoadOptions) |
XmlReader から XElement を読み込み、必要に応じて、空白の維持、ベース URI の設定、および行情報の保持を行います。 |
| LoadAsync(Stream, LoadOptions, CancellationToken) |
新しい XElement を非同期に作成し、指定したストリームを使用してその基になる XML ツリーを初期化します。必要に応じて、空白を維持します。 |
| LoadAsync(TextReader, LoadOptions, CancellationToken) |
新しい XElement を非同期に作成し、指定したテキスト リーダーを使用してその基になる XML ツリーを初期化します。必要に応じて、空白を維持します。 |
| LoadAsync(XmlReader, LoadOptions, CancellationToken) |
新しい XElement を非同期に作成し、指定した XML リーダーを使用してその基になる XML ツリーを初期化します。必要に応じて、空白を維持します。 |
| MemberwiseClone() |
現在の Object の簡易コピーを作成します。 (継承元 Object) |
| Nodes() |
この要素またはドキュメントの子ノードのコレクションをドキュメント順に返します。 (継承元 XContainer) |
| NodesAfterSelf() |
このノードの後にある兄弟ノードのコレクションをドキュメント順に返します。 (継承元 XNode) |
| NodesBeforeSelf() |
このノードの前にある兄弟ノードのコレクションをドキュメント順に返します。 (継承元 XNode) |
| Parse(String) |
XML を格納した文字列から XElement を読み込みます。 |
| Parse(String, LoadOptions) |
XML を格納した文字列から XElement を読み込み、必要に応じて、空白および行情報を保持します。 |
| Remove() |
現在のノードを親から削除します。 (継承元 XNode) |
| RemoveAll() |
この XElement からノードおよび属性を削除します。 |
| RemoveAnnotations(Type) |
この XObject から指定した型の注釈を削除します。 (継承元 XObject) |
| RemoveAnnotations<T>() |
この XObject から指定した型の注釈を削除します。 (継承元 XObject) |
| RemoveAttributes() |
この XElement の属性を削除します。 |
| RemoveNodes() |
このドキュメントまたは要素から子ノードを削除します。 (継承元 XContainer) |
| ReplaceAll(Object) |
この要素の子ノードおよび属性を、指定された内容で置き換えます。 |
| ReplaceAll(Object[]) |
この要素の子ノードおよび属性を、指定された内容で置き換えます。 |
| ReplaceAttributes(Object) |
この要素の属性を、指定された内容で置き換えます。 |
| ReplaceAttributes(Object[]) |
この要素の属性を、指定された内容で置き換えます。 |
| ReplaceNodes(Object) |
このドキュメントまたは要素の子ノードを指定された内容で置き換えます。 (継承元 XContainer) |
| ReplaceNodes(Object[]) |
このドキュメントまたは要素の子ノードを指定された内容で置き換えます。 (継承元 XContainer) |
| ReplaceWith(Object) |
現在のノードを指定された内容に置き換えます。 (継承元 XNode) |
| ReplaceWith(Object[]) |
現在のノードを指定された内容に置き換えます。 (継承元 XNode) |
| Save(Stream) | |
| Save(Stream, SaveOptions) | |
| Save(String) |
この要素をシリアル化してファイルに書き込みます。 |
| Save(String, SaveOptions) |
この要素をシリアル化してファイルに書き込み、オプションで、書式設定を無効にします。 |
| Save(TextWriter) |
この要素をシリアル化して TextWriter に書き込みます。 |
| Save(TextWriter, SaveOptions) |
この要素をシリアル化して TextWriter に書き込み、必要に応じて、書式設定を無効にします。 |
| Save(XmlWriter) |
この要素をシリアル化して XmlWriter に書き込みます。 |
| SaveAsync(Stream, SaveOptions, CancellationToken) | |
| SaveAsync(TextWriter, SaveOptions, CancellationToken) |
この XElement を非同期的に TextWriter に出力します。 |
| SaveAsync(XmlWriter, CancellationToken) | |
| SetAttributeValue(XName, Object) |
属性の値の設定、属性の追加、または属性の削除を行います。 |
| SetElementValue(XName, Object) |
子要素の値の設定、子要素の追加、または子要素の削除を行います。 |
| SetValue(Object) |
現在の要素の値を設定します。 |
| ToString() |
このノードに対してインデントが設定された XML を返します。 (継承元 XNode) |
| ToString(SaveOptions) |
このノードに対して XML を返し、オプションで書式設定を無効にします。 (継承元 XNode) |
| WriteTo(XmlWriter) |
この要素を XmlWriter に書き込みます。 |
| WriteToAsync(XmlWriter, CancellationToken) |
この XElement を指定したライターに非同期的に書き込みます。 |
| 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) |
| IXmlSerializable.GetSchema() |
このオブジェクトの XML 表現を記述する XML スキーマ定義を取得します。 |
| IXmlSerializable.ReadXml(XmlReader) |
XML 表現からオブジェクトを生成します。 |
| IXmlSerializable.WriteXml(XmlWriter) |
オブジェクトを XML 表現に変換します。 |
拡張メソッド
適用対象
こちらもご覧ください
.NET