XContainer.Descendants Metoda

Definicja

Zwraca kolekcję elementów podrzędnych dla tego dokumentu lub elementu w kolejności dokumentu.

Przeciążenia

Descendants()

Zwraca kolekcję elementów podrzędnych dla tego dokumentu lub elementu w kolejności dokumentu.

Descendants(XName)

Zwraca odfiltrowaną kolekcję elementów podrzędnych dla tego dokumentu lub elementu w kolejności dokumentu. W kolekcji znajdują się tylko elementy, które mają dopasowanie XName .

Uwagi

Ta metoda używa odroczonego wykonania.

Descendants()

Źródło:
XContainer.cs
Źródło:
XContainer.cs
Źródło:
XContainer.cs

Zwraca kolekcję elementów podrzędnych dla tego dokumentu lub elementu w kolejności dokumentu.

C#
public System.Collections.Generic.IEnumerable<System.Xml.Linq.XElement> Descendants();

Zwraca

XElement Element IEnumerable<T> zawierający elementy podrzędne elementu XContainer.

Przykłady

Poniższy przykład tworzy drzewo XML, a następnie używa tej metody osi do pobierania elementów potomnych.

C#
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);  

Ten przykład generuje następujące wyniki:

Child  
GrandChild  

Uwagi

Należy pamiętać, że ta metoda nie zwróci się w wynikowej IEnumerable<T>metodzie . Sprawdź DescendantsAndSelf , czy musisz uwzględnić bieżący element XElement w wynikach.

Ta metoda używa odroczonego wykonania.

Zobacz też

Dotyczy

.NET 10 i inne wersje
Produkt Wersje
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Descendants(XName)

Źródło:
XContainer.cs
Źródło:
XContainer.cs
Źródło:
XContainer.cs

Zwraca odfiltrowaną kolekcję elementów podrzędnych dla tego dokumentu lub elementu w kolejności dokumentu. W kolekcji znajdują się tylko elementy, które mają dopasowanie XName .

C#
public System.Collections.Generic.IEnumerable<System.Xml.Linq.XElement> Descendants(System.Xml.Linq.XName name);
C#
public System.Collections.Generic.IEnumerable<System.Xml.Linq.XElement> Descendants(System.Xml.Linq.XName? name);

Parametry

name
XName

Element XName do dopasowania.

Zwraca

XElement Element IEnumerable<T> zawierający elementy podrzędne elementu XContainer zgodnego z określonym XNameelementem .

Przykłady

Poniższy przykład wyświetla wszystkie elementy podrzędne elementu.

C#
// 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);  

Ten przykład generuje następujące wyniki:

Child  

Poniżej przedstawiono ten sam przykład, ale w tym przypadku kod XML znajduje się w przestrzeni nazw. Aby uzyskać więcej informacji, zobacz Praca z przestrzeniami nazw XML.

C#
// 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);  

Ten przykład generuje następujące wyniki:

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

Uwagi

Ta metoda używa odroczonego wykonania.

Zobacz też

Dotyczy

.NET 10 i inne wersje
Produkt Wersje
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0