Export (0) Print
Expand All

Extensions.DescendantNodes(Of T) Method

Returns a collection of the descendant nodes of every document and element in the source collection.

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

'Declaration
<ExtensionAttribute> _
Public Shared Function DescendantNodes(Of T As XContainer) ( _
	source As IEnumerable(Of T) _
) As IEnumerable(Of XNode)

Type Parameters

T

The type of the objects in source, constrained to XContainer.

Parameters

source
Type: System.Collections.Generic.IEnumerable(Of T)
An IEnumerable(Of T) of XContainer that contains the source collection.

Return Value

Type: System.Collections.Generic.IEnumerable(Of XNode)
An IEnumerable(Of T) of XNode of the descendant nodes of every document and element in the source collection.

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type IEnumerable(Of T). When you use instance method syntax to call this method, omit the first parameter.

ExceptionCondition
ArgumentNullException

source is Nothing.

This axis extension method is used on XDocument and XElement objects. Both of these types derive from XContainer, so this method operates on an IEnumerable(Of T) of XContainer that contains the source collection.

Although Visual Basic has an integrated XML axis for descendant elements, there is no integrated axis for descendant nodes, so Visual Basic users must use this axis method explicitly.

This method uses deferred execution.

The following example retrieves a collection of two elements, and then retrieves a collection of all descendant nodes for every element in the source collection. Note that the attribute of the GrandChild element is not surfaced as a node.


Dim output As New StringBuilder
Dim xmlTree As XElement = _
<Root>
    <Child>aaa<GrandChild anAttribute='xyz'>Text</GrandChild>
        <!--a comment-->
        <?xml-stylesheet type='text/xsl' href='test.xsl'?>
    </Child>
    <Child>ccc<GrandChild>Text</GrandChild>ddd</Child>
</Root>

Dim nodes As IEnumerable(Of XNode) = _
    From node In xmlTree.<Child>.DescendantNodes _
    Select node

For Each node As XNode In nodes
    Select Case node.NodeType
        Case XmlNodeType.Element
            output.Append(String.Format("Element: {0}", DirectCast(node, XElement).Name))
            output.Append(Environment.NewLine)
        Case XmlNodeType.Text
            output.Append(String.Format("Text: {0}", DirectCast(node, XText).Value))
            output.Append(Environment.NewLine)
        Case XmlNodeType.Comment
            output.Append(String.Format("Comment: {0}", DirectCast(node, XComment).Value))
            output.Append(Environment.NewLine)
        Case XmlNodeType.ProcessingInstruction
            output.Append(String.Format("PI: {0}", DirectCast(node, XProcessingInstruction).Data))
            output.Append(Environment.NewLine)
    End Select
Next

OutputTextBlock.Text = output.ToString()


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

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

Community Additions

ADD
Show:
© 2014 Microsoft