Editja

Ixxerja permezz ta’

XContainer.Elements Method

Definition

Namespace:
System.Xml.Linq
Assemblies:
System.Xml.Linq.dll, System.Xml.XDocument.dll
Assemblies:
netstandard.dll, System.Xml.XDocument.dll
Assembly:
System.Xml.XDocument.dll
Assembly:
System.Xml.Linq.dll
Assembly:
netstandard.dll

Returns a collection of the child elements of this element or document, in document order.

Overloads

Name Description
Elements()

Returns a collection of the child elements of this element or document, in document order.
Elements(XName)

Returns a filtered collection of the child elements of this element or document, in document order. Only elements that have a matching XName are included in the collection.

Remarks

This method uses deferred execution.

Elements()

Source:
XContainer.cs
Source:
XContainer.cs
Source:
XContainer.cs
Source:
XContainer.cs
Source:
XContainer.cs

Returns a collection of the child elements of this element or document, in document order.

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)

Returns

IEnumerable<XElement>

An IEnumerable<T> of XElement containing the child elements of this XContainer, in document order.

Examples

The following example creates an XML tree, and then selects some elements using this axis method.

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

This example produces the following output:

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

The following is the same example, but in this case the XML is in a namespace. For more information, see Work with 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

This example produces the following output:

<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>

Remarks

This method uses deferred execution.

See also

Applies to

Elements(XName)

Source:
XContainer.cs
Source:
XContainer.cs
Source:
XContainer.cs
Source:
XContainer.cs
Source:
XContainer.cs

Returns a filtered collection of the child elements of this element or document, in document order. Only elements that have a matching XName are included in the collection.

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)

Parameters

name
XName

The XName to match.

Returns

IEnumerable<XElement>

An IEnumerable<T> of XElement containing the children of the XContainer that have a matching XName, in document order.

Examples

The following example creates an XML tree, and then selects several child elements using this axis method.

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

This example produces the following output:

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

The following is the same example, but in this case the XML is in a namespace. For more information, see Work with 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

This example produces the following output:

<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>

Remarks

This method uses deferred execution.

See also

Applies to