Article
11/18/2011

XElement.AncestorsAndSelf Method (XName)

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

Returns a filtered collection of elements that contain this element, and the ancestors of this element. 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)

Syntax

'Declaration
Public Function AncestorsAndSelf ( _
    name As XName _
) As IEnumerable(Of XElement)

public IEnumerable<XElement> AncestorsAndSelf(
    XName name
)

Parameters

name
Type: System.Xml.Linq.XName
The XName to match.

Return Value

Type: System.Collections.Generic.IEnumerable<XElement>
An IEnumerable<T> of XElement that contain this element, and the ancestors of this element. Only elements that have a matching XName are included in the collection.

Remarks

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

This method uses deferred execution.

Examples

The following example uses this axis method.

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) = GC.AncestorsAndSelf("Child")
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 = gc.AncestorsAndSelf("Child");
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.

Share via