XElement クラス

定義

名前空間:

System.Xml.Linq

アセンブリ:

System.Xml.XDocument.dll

Source:

XElement.cs

XML 要素を表します。 使用法の情報と例については、「XElement クラスの概要」およびこのページの「解説」セクションを参照してください。

public ref class XElement : System::Xml::Linq::XContainer, System::Xml::Serialization::IXmlSerializable

public class XElement : System.Xml.Linq.XContainer, System.Xml.Serialization.IXmlSerializable

type XElement = class
    inherit XContainer
    interface IXmlSerializable

Public Class XElement
Inherits XContainer
Implements IXmlSerializable

継承

Object

XObject

XNode

XContainer

XElement

実装

IXmlSerializable

例

次の例では、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

• XComment

• XProcessingInstruction

• XText

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

XElement は から XContainer派生します。これは から XNode派生します。

一部 XElement のメソッドは XAML から使用できます。 詳細については、「LINQ to XML の動的プロパティ」を参照してください。

コンストラクター

XElement(XElement)	他の 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)	readerOptions パラメーターでオプションを指定して、XmlReader を作成します。 (継承元 XNode)
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)	XmlReader から XElement を読み込みます。
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)	この XElement を指定した Stream に出力します。
Save(Stream, SaveOptions)	オプションで書式設定動作を指定して、この XElement を指定した Stream に出力します。
Save(String)	この要素をシリアル化してファイルに書き込みます。
Save(String, SaveOptions)	この要素をシリアル化してファイルに書き込み、オプションで、書式設定を無効にします。
Save(TextWriter)	この要素をシリアル化して TextWriter に書き込みます。
Save(TextWriter, SaveOptions)	この要素をシリアル化して TextWriter に書き込み、必要に応じて、書式設定を無効にします。
Save(XmlWriter)	この要素をシリアル化して XmlWriter に書き込みます。
SaveAsync(Stream, SaveOptions, CancellationToken)	この XElement を非同期的に Stream に出力します。
SaveAsync(TextWriter, SaveOptions, CancellationToken)	この XElement を非同期的に TextWriter に出力します。
SaveAsync(XmlWriter, CancellationToken)	この XElement を非同期的に XmlWriter に出力します。
SetAttributeValue(XName, Object)	属性の値の設定、属性の追加、または属性の削除を行います。
SetElementValue(XName, Object)	子要素の値の設定、子要素の追加、または子要素の削除を行います。
SetValue(Object)	現在の要素の値を設定します。
ToString()	このノードに対してインデントが設定された XML を返します。 (継承元 XNode)
ToString(SaveOptions)	このノードに対して XML を返し、オプションで書式設定を無効にします。 (継承元 XNode)
WriteTo(XmlWriter)	この要素を XmlWriter に書き込みます。
WriteToAsync(XmlWriter, CancellationToken)	この XElement を指定したライターに非同期的に書き込みます。

演算子

Explicit(XElement to Boolean)	この XElement の値を Boolean にキャストします。
Explicit(XElement to DateTime)	この XElement の値を DateTime にキャストします。
Explicit(XElement to DateTimeOffset)	この XAttribute の値を DateTimeOffset にキャストします。
Explicit(XElement to Decimal)	この XElement の値を Decimal にキャストします。
Explicit(XElement to Double)	この XElement の値を Double にキャストします。
Explicit(XElement to Guid)	この XElement の値を Guid にキャストします。
Explicit(XElement to Int32)	この XElement の値を Int32 にキャストします。
Explicit(XElement to Int64)	この XElement の値を Int64 にキャストします。
Explicit(XElement to Nullable<Boolean>)	この XElement の値を Boolean の Nullable<T> にキャストします。
Explicit(XElement to Nullable<DateTime>)	この XElement の値を DateTime の Nullable<T> にキャストします。
Explicit(XElement to Nullable<DateTimeOffset>)	この XElement の値を DateTimeOffset の Nullable<T> にキャストします。
Explicit(XElement to Nullable<Decimal>)	この XElement の値を Decimal の Nullable<T> にキャストします。
Explicit(XElement to Nullable<Double>)	この XElement の値を Double の Nullable<T> にキャストします。
Explicit(XElement to Nullable<Guid>)	この XElement の値を Guid の Nullable<T> にキャストします。
Explicit(XElement to Nullable<Int32>)	この XElement の値を Int32 の Nullable<T> にキャストします。
Explicit(XElement to Nullable<Int64>)	この XElement の値を Int64 の Nullable<T> にキャストします。
Explicit(XElement to Nullable<Single>)	この XElement の値を Single の Nullable<T> にキャストします。
Explicit(XElement to Nullable<TimeSpan>)	この XElement の値を TimeSpan の Nullable<T> にキャストします。
Explicit(XElement to Nullable<UInt32>)	この XElement の値を UInt32 の Nullable<T> にキャストします。
Explicit(XElement to Nullable<UInt64>)	この XElement の値を UInt64 の Nullable<T> にキャストします。
Explicit(XElement to Single)	この XElement の値を Single にキャストします。
Explicit(XElement to String)	この XElement の値を String にキャストします。
Explicit(XElement to TimeSpan)	この XElement の値を TimeSpan にキャストします。
Explicit(XElement to UInt32)	この XElement の値を UInt32 にキャストします。
Explicit(XElement to UInt64)	この XElement の値を UInt64 にキャストします。

イベント

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 表現に変換します。

拡張メソッド

GetSchemaInfo(XElement)	検証済み要素のスキーマ検証後の infoset (PSVI) を取得します。
Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler)	このメソッドは、XElement サブツリーが指定した XmlSchemaObject および XmlSchemaSet に準拠しているかどうかを検証します。
Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler, Boolean)	XElement サブツリーが、指定した XmlSchemaObject および XmlSchemaSet に準拠しているかどうかを検証します。必要に応じて、スキーマ検証後の 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 に移動して編集できるアクセサーを返します。

こちらもご覧ください

• LINQ to XML の概要
• LINQ to XML の動的プロパティ