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.
See Also