XContainer.Descendants Método

  • Referência

Definição

Namespace:
System.Xml.Linq
Assembly:
System.Xml.XDocument.dll
Assembly:
System.Xml.Linq.dll
Assembly:
netstandard.dll

Retorna uma coleção dos elementos descendentes desse documento ou elemento, na ordem do documento.

Sobrecargas

Descendants()

Retorna uma coleção dos elementos descendentes desse documento ou elemento, na ordem do documento.
Descendants(XName)

Retorna uma coleção filtrada dos elementos descendentes desse documento ou elemento, na ordem do documento. Somente os elementos que têm um XName correspondente são incluídos na coleção.

Comentários

Este método utiliza execução adiada.

Descendants()

Retorna uma coleção dos elementos descendentes desse documento ou elemento, na ordem do documento.

public:
 System::Collections::Generic::IEnumerable<System::Xml::Linq::XElement ^> ^ Descendants();
public System.Collections.Generic.IEnumerable<System.Xml.Linq.XElement> Descendants ();
member this.Descendants : unit -> seq<System.Xml.Linq.XElement>
Public Function Descendants () As IEnumerable(Of XElement)

Retornos

IEnumerable<XElement>

Um IEnumerable<T> do XElement que contém os elementos descendentes do XContainer.

Exemplos

O exemplo a seguir cria uma árvore XML e usa esse método de eixo para recuperar os descendentes.

XElement xmlTree = new XElement("Root",  
    new XAttribute("Att1", "AttributeContent"),  
    new XElement("Child",  
        new XText("Some text"),  
        new XElement("GrandChild", "element content")  
    )  
);  
IEnumerable<XElement> de =  
    from el in xmlTree.Descendants()  
    select el;  
foreach (XElement el in de)  
    Console.WriteLine(el.Name);  

' Attributes are not nodes, so will not be returned by DescendantNodes.  
Dim xmlTree As XElement = _  
    <Root Att1="AttributeContent">  
        <Child>Some text  
            <GrandChild>element content</GrandChild>  
        </Child>  
    </Root>  
Dim de = From el In xmlTree.Descendants _  
         Select el  

For Each el In de  
    Console.WriteLine(el.Name)  
Next

Esse exemplo gera a saída a seguir:

Child  
GrandChild

Comentários

Observe que esse método não retornará a si mesmo no resultado IEnumerable<T>. Veja DescendantsAndSelf se você precisa incluir a corrente XElement nos resultados.

Este método utiliza execução adiada.

Confira também

Aplica-se a

Descendants(XName)

Retorna uma coleção filtrada dos elementos descendentes desse documento ou elemento, na ordem do documento. Somente os elementos que têm um XName correspondente são incluídos na coleção.

public:
 System::Collections::Generic::IEnumerable<System::Xml::Linq::XElement ^> ^ Descendants(System::Xml::Linq::XName ^ name);
public System.Collections.Generic.IEnumerable<System.Xml.Linq.XElement> Descendants (System.Xml.Linq.XName name);
public System.Collections.Generic.IEnumerable<System.Xml.Linq.XElement> Descendants (System.Xml.Linq.XName? name);
member this.Descendants : System.Xml.Linq.XName -> seq<System.Xml.Linq.XElement>
Public Function Descendants (name As XName) As IEnumerable(Of XElement)

Parâmetros

name
XName

O XName correspondente.

Retornos

IEnumerable<XElement>

Um IEnumerable<T> de XElement que contém os elementos descendentes do XContainer que correspondem ao XName especificado.

Exemplos

O exemplo a seguir imprime todos os descendentes de um elemento.

// Attributes are not nodes, so will not be returned by DescendantNodes.  
XElement xmlTree = new XElement("Root",  
    new XAttribute("Att1", "AttributeContent"),  
    new XElement("Child",  
        new XText("Some text"),  
        new XElement("GrandChild", "element content")  
    )  
);  
IEnumerable<XElement> de =  
    from el in xmlTree.Descendants("Child")  
    select el;  
foreach (XElement el in de)  
    Console.WriteLine(el.Name);  

' Attributes are not nodes, so will not be returned by the descendants axis.  
Dim xmlTree As XElement = _   
    <Root Att1="AttributeContent">  
         <Child>Some text  
             <GrandChild>element content</GrandChild>  
         </Child>  
     </Root>  

Dim de = From el In xmlTree...<Child> _  
         Select el  

For Each el In de  
    Console.WriteLine(el.Name)  
Next

Esse exemplo gera a saída a seguir:

Child

O exemplo a seguir é o mesmo, mas nesse caso o XML está em um namespace. Para obter mais informações, consulte Work with XML Namespaces.

// Attributes are not nodes, so will not be returned by DescendantNodes.  
XNamespace aw = "http://www.adventure-works.com";  
XElement xmlTree = new XElement(aw + "Root",  
    new XAttribute(aw + "Att1", "AttributeContent"),  
    new XElement(aw + "Child",  
        new XText("Some text"),  
        new XElement(aw + "GrandChild", "element content")  
    )  
);  
IEnumerable<XElement> de =  
    from el in xmlTree.Descendants(aw + "Child")  
    select el;  
foreach (XElement el in de)  
    Console.WriteLine(el.Name);  

Imports <xmlns:aw = "http://www.adventure-works.com">  

Module Module1  
    Sub Main()  
        ' Attributes are not nodes, so will not be returned by the descendants axis.  
        Dim xmlTree As XElement = _   
            <aw:Root aw:Att1="AttributeContent">  
                 <aw:Child>Some text  
                     <aw:GrandChild>element content</aw:GrandChild>  
                 </aw:Child>  
             </aw:Root>  

        Dim de = From el In xmlTree...<aw:Child> _  
                 Select el  

        For Each el In de  
            Console.WriteLine(el.Name)  
        Next  
    End Sub  
End Module

Esse exemplo gera a saída a seguir:

{http://www.adventure-works.com}Child

Comentários

Este método utiliza execução adiada.

Confira também

Aplica-se a