XNode.Ancestors Method (XName)

 

Returns a filtered collection of the ancestor elements of this node. Only elements that have a matching XName are included in the collection.

Namespace:   System.Xml.Linq
Assembly:  System.Xml.Linq (in System.Xml.Linq.dll)

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

Parameters

name
Type: System.Xml.Linq.XName

The XName to match.

Return Value

Type: System.Collections.Generic.IEnumerable(Of XElement)

An IEnumerable(Of T) of XElement of the ancestor elements of this node. Only elements that have a matching XName are included in the collection.

The nodes in the returned collection are in reverse document order.

This method uses deferred execution.

This method will not return itself in the results.

The following example uses this method.


                Dim xmlTree As XElement = _ 
        <Root>
            <Child>
                <GrandChild>content</GrandChild>
            </Child>
        </Root>

Dim grandChild As IEnumerable(Of XElement) = xmlTree...<GrandChild>
For Each el In grandChild.Ancestors("Child")
    Console.WriteLine(el.Name)
Next

This example produces the following output:


Child

Universal Windows Platform
Available since 8
.NET Framework
Available since 3.5
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show: