XElement クラス

定義

名前空間:: System.Xml.Linq

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

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

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

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

アセンブリ:: netstandard.dll

ソース:: XElement.cs

ソース:: XElement.cs

ソース:: XElement.cs

ソース:: XElement.cs

ソース:: XElement.cs

重要

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

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

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

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

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

public class XElement : System.Xml.Linq.XContainer

type XElement = class
    inherit XContainer
    interface IXmlSerializable

type XElement = class
    inherit XContainer

Public Class XElement
Inherits XContainer
Implements IXmlSerializable

Public Class XElement
Inherits XContainer

継承: 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の有効なコンテンツの詳細については、「XElement オブジェクトと XDocument オブジェクトの有効なコンテンツ」を参照してください。

XElementは、XNodeから派生したXContainerから派生します。

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

コンストラクター

名前	説明
XElement(XElement)	別のXElement オブジェクトからXElement クラスの新しいインスタンスを初期化します。
XElement(XName, Object)	指定した名前とコンテンツを使用して、 XElement クラスの新しいインスタンスを初期化します。
XElement(XName, Object[])	指定した名前とコンテンツを使用して、 XElement クラスの新しいインスタンスを初期化します。
XElement(XName)	指定した名前を使用して、 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)	XmlReader パラメーターで指定されたオプションを使用して`readerOptions`を作成します。 (継承元 XNode)
CreateWriter()	XContainerにノードを追加するために使用できるXmlWriterを作成します。 (継承元 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()	このXNamespaceの既定のXElementを取得します。
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetNamespaceOfPrefix(String)	この XElementの特定のプレフィックスに関連付けられている名前空間を取得します。
GetPrefixOfNamespace(XNamespace)	この XElementの名前空間に関連付けられているプレフィックスを取得します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
IsAfter(XNode)	ドキュメントの順序で指定したノードの後に現在のノードが表示されるかどうかを判断します。 (継承元 XNode)
IsBefore(XNode)	ドキュメントの順序で、指定したノードの前に現在のノードが表示されるかどうかを判断します。 (継承元 XNode)
Load(Stream, LoadOptions)	指定したストリームを使用して新しい XElement インスタンスを作成し、必要に応じて空白を保持し、ベース URI を設定し、行情報を保持します。
Load(Stream)	指定したストリームを使用して、新しい XElement インスタンスを作成します。
Load(String, LoadOptions)	ファイルから XElement を読み込み、必要に応じて空白を保持し、ベース URI を設定し、行情報を保持します。
Load(String)	ファイルから XElement を読み込みます。
Load(TextReader, LoadOptions)	TextReaderからXElementを読み込み、必要に応じて空白を保持し、行情報を保持します。
Load(TextReader)	TextReaderからXElementを読み込みます。
Load(XmlReader, LoadOptions)	XmlReaderからXElementを読み込み、必要に応じて空白を保持し、ベース URI を設定し、行情報を保持します。
Load(XmlReader)	XmlReaderからXElementを読み込みます。
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, LoadOptions)	XML を含む文字列から XElement を読み込み、必要に応じて空白を保持し、行情報を保持します。
Parse(String)	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, SaveOptions)	この XElement を指定した Streamに出力し、必要に応じて書式設定の動作を指定します。
Save(Stream)	この XElement を指定した Streamに出力します。
Save(String, SaveOptions)	この要素をファイルにシリアル化し、必要に応じて書式設定を無効にします。
Save(String)	この要素をファイルにシリアル化します。
Save(TextWriter, SaveOptions)	この要素を TextWriterにシリアル化し、必要に応じて書式設定を無効にします。
Save(TextWriter)	この要素を 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の値をNullable<T>のBooleanにキャストします。
Explicit(XElement to Nullable<DateTime>)	このXElementの値をNullable<T>のDateTimeにキャストします。
Explicit(XElement to Nullable<DateTimeOffset>)	このXElementの値をNullable<T>のDateTimeOffsetにキャストします。
Explicit(XElement to Nullable<Decimal>)	このXElementの値をNullable<T>のDecimalにキャストします。
Explicit(XElement to Nullable<Double>)	このXElementの値をNullable<T>のDoubleにキャストします。
Explicit(XElement to Nullable<Guid>)	このXElementの値をNullable<T>のGuidにキャストします。
Explicit(XElement to Nullable<Int32>)	このXElementの値をNullable<T>のInt32にキャストします。
Explicit(XElement to Nullable<Int64>)	このXElementの値をNullable<T>のInt64にキャストします。
Explicit(XElement to Nullable<Single>)	このXElementの値をNullable<T>のSingleにキャストします。
Explicit(XElement to Nullable<TimeSpan>)	このXElementの値をNullable<T>のTimeSpanにキャストします。
Explicit(XElement to Nullable<UInt32>)	このXElementの値をNullable<T>のUInt32にキャストします。
Explicit(XElement to Nullable<UInt64>)	このXElementの値をNullable<T>のUInt64にキャストします。
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 表現に変換します。

拡張メソッド

名前	説明
CreateNavigator(XNode, XmlNameTable)	XPathNavigatorのXNodeを作成します。 XmlNameTableを使用すると、より効率的な XPath 式処理が可能になります。
CreateNavigator(XNode)	XPathNavigatorのXNodeを作成します。
GetSchemaInfo(XElement)	検証済み要素のスキーマ検証後情報セット (PSVI) を取得します。
ToXPathNavigable(XNode)	指定した XNode内を移動して編集できるアクセサーを返します。
Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler, Boolean)	XElementサブツリーが指定したXmlSchemaObjectとXmlSchemaSetに準拠していることを検証します。必要に応じて、XML ツリーにスキーマ検証後情報セット (PSVI) を設定します。
Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler)	このメソッドは、 XElement サブツリーが指定した XmlSchemaObject と XmlSchemaSetに準拠していることを検証します。
XPathEvaluate(XNode, String, IXmlNamespaceResolver)	指定した IXmlNamespaceResolverを使用して名前空間プレフィックスを解決して、XPath 式を評価します。
XPathEvaluate(XNode, String)	XPath 式を評価します。
XPathSelectElement(XNode, String, IXmlNamespaceResolver)	XPath 式を使用して XElement を選択し、指定した IXmlNamespaceResolverを使用して名前空間プレフィックスを解決します。
XPathSelectElement(XNode, String)	XPath 式を使用して XElement を選択します。
XPathSelectElements(XNode, String, IXmlNamespaceResolver)	XPath 式を使用して要素のコレクションを選択し、指定した IXmlNamespaceResolverを使用して名前空間プレフィックスを解決します。
XPathSelectElements(XNode, String)	XPath 式を使用して要素のコレクションを選択します。

適用対象

こちらもご覧ください

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

フィードバック

このページはお役に立ちましたか?