XContainer.Elements Methode

Definition

Namespace:: System.Xml.Linq

Assemblys:: System.Xml.Linq.dll, System.Xml.XDocument.dll

Assemblys:: netstandard.dll, System.Xml.XDocument.dll

Assembly:: System.Xml.XDocument.dll

Assembly:: System.Xml.Linq.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt eine Auflistung der untergeordneten Elemente dieses Elements oder Dokuments in der Dokumentreihenfolge zurück.

Überlädt

Name	Beschreibung
Elements()	Gibt eine Auflistung der untergeordneten Elemente dieses Elements oder Dokuments in der Dokumentreihenfolge zurück.
Elements(XName)	Gibt eine gefilterte Auflistung der untergeordneten Elemente dieses Elements oder Dokuments in der Dokumentreihenfolge zurück. In der Auflistung sind nur Elemente enthalten, die über einen übereinstimmenden XName verfügen.

Hinweise

Diese Methode verwendet verzögerte Ausführung.

Elements()

Quelle:: XContainer.cs

Quelle:: XContainer.cs

Quelle:: XContainer.cs

Quelle:: XContainer.cs

Quelle:: XContainer.cs

Gibt eine Auflistung der untergeordneten Elemente dieses Elements oder Dokuments in der Dokumentreihenfolge zurück.

public:
 System::Collections::Generic::IEnumerable<System::Xml::Linq::XElement ^> ^ Elements();

public System.Collections.Generic.IEnumerable<System.Xml.Linq.XElement> Elements();

member this.Elements : unit -> seq<System.Xml.Linq.XElement>

Public Function Elements () As IEnumerable(Of XElement)

Gibt zurück

IEnumerable<XElement>

Ein Element IEnumerable<T> , XElement das die untergeordneten Elemente dieses XContainerElements enthält, in der Dokumentreihenfolge.

Beispiele

Im folgenden Beispiel wird eine XML-Struktur erstellt und dann einige Elemente mithilfe dieser Achsenmethode ausgewählt.

XElement xmlTree = new XElement("Root",
    new XElement("Child1", 1),
    new XElement("Child2", 2),
    new XElement("Child3", 3),
    new XElement("Child4", 4),
    new XElement("Child5", 5)
);
IEnumerable<XElement> elements =
    from el in xmlTree.Elements()
    where (int)el <= 3
    select el;
foreach (XElement el in elements)
    Console.WriteLine(el);

Dim xmlTree As XElement = _
        <Root>
            <Child1>1</Child1>
            <Child2>2</Child2>
            <Child3>3</Child3>
            <Child4>4</Child4>
            <Child5>5</Child5>
        </Root>

Dim elements = From el In xmlTree.Elements _
               Where el.Value <= 3 _
               Select el

For Each el In elements
    Console.WriteLine(el)
Next

Dieses Beispiel erzeugt die folgende Ausgabe:

<Child1>1</Child1>
<Child2>2</Child2>
<Child3>3</Child3>

Nachfolgend sehen Sie das gleiche Beispiel, aber in diesem Fall befindet sich der XML-Code in einem Namespace. Weitere Informationen finden Sie unter Arbeiten mit XML-Namespaces.

XNamespace aw = "http://www.adventure-works.com";
XElement xmlTree = new XElement(aw + "Root",
    new XAttribute(XNamespace.Xmlns + "aw", "http://www.adventure-works.com"),
    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)
);
IEnumerable<XElement> elements =
    from el in xmlTree.Elements()
    where (int)el <= 3
    select el;
foreach (XElement el in elements)
    Console.WriteLine(el);

Imports <xmlns:aw="http://www.adventure-works.com">

Module Module1
    Sub Main()
        Dim xmlTree As XElement = _
            <aw:Root>
                <aw:Child1>1</aw:Child1>
                <aw:Child2>2</aw:Child2>
                <aw:Child3>3</aw:Child3>
                <aw:Child4>4</aw:Child4>
                <aw:Child5>5</aw:Child5>
            </aw:Root>

        Dim elements = From el In xmlTree.Elements _
                       Where el.Value <= 3 _
                       Select el

        For Each el In elements
            Console.WriteLine(el)
        Next
    End Sub
End Module

Dieses Beispiel erzeugt die folgende Ausgabe:

<aw:Child1 xmlns:aw="http://www.adventure-works.com">1</aw:Child1>
<aw:Child2 xmlns:aw="http://www.adventure-works.com">2</aw:Child2>
<aw:Child3 xmlns:aw="http://www.adventure-works.com">3</aw:Child3>

Hinweise

Diese Methode verwendet verzögerte Ausführung.

Weitere Informationen

Gilt für:

Elements(XName)

Quelle:: XContainer.cs

Quelle:: XContainer.cs

Quelle:: XContainer.cs

Quelle:: XContainer.cs

Quelle:: XContainer.cs

Gibt eine gefilterte Auflistung der untergeordneten Elemente dieses Elements oder Dokuments in der Dokumentreihenfolge zurück. In der Auflistung sind nur Elemente enthalten, die über einen übereinstimmenden XName verfügen.

public:
 System::Collections::Generic::IEnumerable<System::Xml::Linq::XElement ^> ^ Elements(System::Xml::Linq::XName ^ name);

public System.Collections.Generic.IEnumerable<System.Xml.Linq.XElement> Elements(System.Xml.Linq.XName name);

public System.Collections.Generic.IEnumerable<System.Xml.Linq.XElement> Elements(System.Xml.Linq.XName? name);

member this.Elements : System.Xml.Linq.XName -> seq<System.Xml.Linq.XElement>

Public Function Elements (name As XName) As IEnumerable(Of XElement)

Parameter

name: XName

Die XName Übereinstimmung.

Gibt zurück

IEnumerable<XElement>

Ein Element IEnumerable<T> , XElement das die untergeordneten Elemente der untergeordneten Elemente enthält, die XContainer in der Dokumentreihenfolge übereinstimmen XName.

Beispiele

Im folgenden Beispiel wird eine XML-Struktur erstellt und anschließend mehrere untergeordnete Elemente mithilfe dieser Achsenmethode ausgewählt.

XElement xmlTree = new XElement("Root",
    new XElement("Type1", 1),
    new XElement("Type1", 2),
    new XElement("Type2", 3),
    new XElement("Type2", 4),
    new XElement("Type2", 5)
);
IEnumerable<XElement> elements =
    from el in xmlTree.Elements("Type2")
    select el;
foreach (XElement el in elements)
    Console.WriteLine(el);

Dim xmlTree As XElement = _
        <Root>
            <Type1>1</Type1>
            <Type1>2</Type1>
            <Type2>3</Type2>
            <Type2>4</Type2>
            <Type2>5</Type2>
        </Root>

Dim elements = From el In xmlTree.<Type2> _
               Select el

For Each el In elements
    Console.WriteLine(el)
Next

Dieses Beispiel erzeugt die folgende Ausgabe:

<Type2>3</Type2>
<Type2>4</Type2>
<Type2>5</Type2>

Nachfolgend sehen Sie das gleiche Beispiel, aber in diesem Fall befindet sich der XML-Code in einem Namespace. Weitere Informationen finden Sie unter Arbeiten mit XML-Namespaces.

XNamespace aw = "http://www.adventure-works.com";
XElement xmlTree = new XElement(aw + "Root",
    new XAttribute(XNamespace.Xmlns + "aw", "http://www.adventure-works.com"),
    new XElement(aw + "Type1", 1),
    new XElement(aw + "Type1", 2),
    new XElement(aw + "Type2", 3),
    new XElement(aw + "Type2", 4),
    new XElement(aw + "Type2", 5)
);
IEnumerable<XElement> elements =
    from el in xmlTree.Elements(aw + "Type2")
    select el;
foreach (XElement el in elements)
    Console.WriteLine(el);

Imports <xmlns:aw="http://www.adventure-works.com">

Module Module1
    Sub Main()
        Dim xmlTree As XElement = _
            <aw:Root>
                <aw:Type1>1</aw:Type1>
                <aw:Type1>2</aw:Type1>
                <aw:Type2>3</aw:Type2>
                <aw:Type2>4</aw:Type2>
                <aw:Type2>5</aw:Type2>
            </aw:Root>

        Dim elements = From el In xmlTree.<aw:Type2> _
                       Select el

        For Each el In elements
            Console.WriteLine(el)
        Next
    End Sub
End Module

Dieses Beispiel erzeugt die folgende Ausgabe:

<aw:Type2 xmlns:aw="http://www.adventure-works.com">3</aw:Type2>
<aw:Type2 xmlns:aw="http://www.adventure-works.com">4</aw:Type2>
<aw:Type2 xmlns:aw="http://www.adventure-works.com">5</aw:Type2>

Hinweise

Diese Methode verwendet verzögerte Ausführung.

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?