XElement.AncestorsAndSelf Method

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Returns a collection of elements that contain this element, and the ancestors of this element.

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

Syntax

'Declaration
Public Function AncestorsAndSelf As IEnumerable(Of XElement)
public IEnumerable<XElement> AncestorsAndSelf()

Return Value

Type: System.Collections.Generic.IEnumerable<XElement>
An IEnumerable<T> of XElement of elements that contain this element, and the ancestors of this element.

Remarks

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

This method uses deferred execution.

Examples

The following example creates an XML tree. It then finds the GrandChild element, and then prints the ancestors of it.

Dim output As New StringBuilder
Dim xmlTree As XElement = _
    <Root>
        <Child>
            <GrandChild>element content</GrandChild>
        </Child>
    </Root>

Dim GC As XElement = xmlTree.<Child>.<GrandChild>(0)

Dim aas As IEnumerable(Of XElement) = _
    From el In GC.AncestorsAndSelf() _
    Select el

For Each el In aas
    output.Append(el.Name)
    output.Append(Environment.NewLine)
Next


OutputTextBlock.Text = output.ToString()
StringBuilder output = new StringBuilder();
XElement xmlTree = new XElement("Root",
    new XElement("Child",
        new XElement("GrandChild", "element content")
    )
);
XElement gc = xmlTree.Element("Child").Element("GrandChild");
IEnumerable<XElement> aas =
    from el in gc.AncestorsAndSelf()
    select el;
foreach (XElement el in aas)
    output.Append(el.Name + Environment.NewLine);

OutputTextBlock.Text = output.ToString();

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.