XContainer.Elements Metoda

Definicja

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

Przeciążenia

Elements()

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

Elements(XName)

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

Uwagi

Ta metoda używa odroczonego wykonania.

Elements()

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

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

Zwraca

IEnumerable<XElement>

XElement Element IEnumerable<T> zawierający elementy podrzędne tego XContainerelementu w kolejności dokumentu.

Przykłady

Poniższy przykład tworzy drzewo XML, a następnie wybiera niektóre elementy przy użyciu tej metody osi.

C#
XElement xmlTree = new XElement("Root",  
    new XElement("Child1", 1),  
    new XElement("Child2", 2),  
    new XElement("Child3", 3),  
    new XElement("Child4", 4),  
    new XElement("Child5", 5)  
);  
IEnumerable<XElement> elements =  
    from el in xmlTree.Elements()  
    where (int)el <= 3  
    select el;  
foreach (XElement el in elements)  
    Console.WriteLine(el);  

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

<Child1>1</Child1>  
<Child2>2</Child2>  
<Child3>3</Child3>  

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#
XNamespace aw = "http://www.adventure-works.com";  
XElement xmlTree = new XElement(aw + "Root",  
    new XAttribute(XNamespace.Xmlns + "aw", "http://www.adventure-works.com"),  
    new XElement(aw + "Child1", 1),  
    new XElement(aw + "Child2", 2),  
    new XElement(aw + "Child3", 3),  
    new XElement(aw + "Child4", 4),  
    new XElement(aw + "Child5", 5)  
);  
IEnumerable<XElement> elements =  
    from el in xmlTree.Elements()  
    where (int)el <= 3  
    select el;  
foreach (XElement el in elements)  
    Console.WriteLine(el);  

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

<aw:Child1 xmlns:aw="http://www.adventure-works.com">1</aw:Child1>  
<aw:Child2 xmlns:aw="http://www.adventure-works.com">2</aw:Child2>  
<aw:Child3 xmlns:aw="http://www.adventure-works.com">3</aw:Child3>  

Uwagi

Ta metoda używa odroczonego wykonania.

Zobacz też

Dotyczy

.NET 7 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
.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
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Elements(XName)

Zwraca odfiltrowaną kolekcję elementów podrzędnych tego elementu lub dokumentu 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> Elements (System.Xml.Linq.XName name);
C#
public System.Collections.Generic.IEnumerable<System.Xml.Linq.XElement> Elements (System.Xml.Linq.XName? name);

Parametry

name
XName

Element XName do dopasowania.

Zwraca

IEnumerable<XElement>

XElement Element IEnumerable<T> zawierający elementy podrzędne XContainer obiektu, które mają pasujący XNameelement , w kolejności dokumentu.

Przykłady

Poniższy przykład tworzy drzewo XML, a następnie wybiera kilka elementów podrzędnych przy użyciu tej metody osi.

C#
XElement xmlTree = new XElement("Root",  
    new XElement("Type1", 1),  
    new XElement("Type1", 2),  
    new XElement("Type2", 3),  
    new XElement("Type2", 4),  
    new XElement("Type2", 5)  
);  
IEnumerable<XElement> elements =  
    from el in xmlTree.Elements("Type2")  
    select el;  
foreach (XElement el in elements)  
    Console.WriteLine(el);  

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

<Type2>3</Type2>  
<Type2>4</Type2>  
<Type2>5</Type2>  

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#
XNamespace aw = "http://www.adventure-works.com";  
XElement xmlTree = new XElement(aw + "Root",  
    new XAttribute(XNamespace.Xmlns + "aw", "http://www.adventure-works.com"),  
    new XElement(aw + "Type1", 1),  
    new XElement(aw + "Type1", 2),  
    new XElement(aw + "Type2", 3),  
    new XElement(aw + "Type2", 4),  
    new XElement(aw + "Type2", 5)  
);  
IEnumerable<XElement> elements =  
    from el in xmlTree.Elements(aw + "Type2")  
    select el;  
foreach (XElement el in elements)  
    Console.WriteLine(el);  

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

<aw:Type2 xmlns:aw="http://www.adventure-works.com">3</aw:Type2>  
<aw:Type2 xmlns:aw="http://www.adventure-works.com">4</aw:Type2>  
<aw:Type2 xmlns:aw="http://www.adventure-works.com">5</aw:Type2>  

Uwagi

Ta metoda używa odroczonego wykonania.

Zobacz też

Dotyczy

.NET 7 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
.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
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0