XContainer.Descendants Metode

Definisi

Ruang nama:

System.Xml.Linq

Rakitan:

netstandard.dll, System.Xml.XDocument.dll

Mengembalikan kumpulan elemen turunan untuk dokumen atau elemen ini, dalam urutan dokumen.

Overload

Nama	Deskripsi
Descendants()	Mengembalikan kumpulan elemen turunan untuk dokumen atau elemen ini, dalam urutan dokumen.
Descendants(XName)	Mengembalikan kumpulan elemen turunan yang difilter untuk dokumen atau elemen ini, dalam urutan dokumen. Hanya elemen yang memiliki XName yang cocok yang disertakan dalam koleksi.

Keterangan

Metode ini menggunakan eksekusi yang ditangguhkan.

Descendants()

Sumber:

XContainer.cs

Mengembalikan kumpulan elemen turunan untuk dokumen atau elemen ini, dalam urutan dokumen.

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)

Mengembalikan

IEnumerable<XElement>

Berisi IEnumerable<T>XElement elemen turunan dari XContainer.

Contoh

Contoh berikut membuat pohon XML, lalu menggunakan metode sumbu ini untuk mengambil turunan.

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

Contoh ini menghasilkan output berikut:

Child
GrandChild

Keterangan

Perhatikan bahwa metode ini tidak akan mengembalikan dirinya sendiri dalam hasil IEnumerable<T>. Lihat DescendantsAndSelf apakah Anda perlu menyertakan saat ini XElement dalam hasilnya.

Metode ini menggunakan eksekusi yang ditangguhkan.

Lihat juga

• DescendantsAndSelf()
• DescendantNodes()
• Elements
• Gambaran umum LINQ ke XML

Descendants(XName)

Sumber:

XContainer.cs

Mengembalikan kumpulan elemen turunan yang difilter untuk dokumen atau elemen ini, dalam urutan dokumen. Hanya elemen yang memiliki XName yang cocok yang disertakan dalam koleksi.

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)

Parameter

name

XName

Untuk XName mencocokkan.

Mengembalikan

IEnumerable<XElement>

Dari IEnumerable<T>XElement berisi elemen turunan dari XContainer yang cocok dengan yang ditentukan XName.

Contoh

Contoh berikut mencetak semua turunan elemen.

// 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

Contoh ini menghasilkan output berikut:

Child

Berikut ini adalah contoh yang sama, tetapi dalam hal ini XML berada di namespace layanan. Untuk informasi selengkapnya, lihat Bekerja dengan Namespace XML.

// 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

Contoh ini menghasilkan output berikut:

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

Keterangan

Metode ini menggunakan eksekusi yang ditangguhkan.

Lihat juga

• DescendantNodes()
• Elements
• Gambaran umum LINQ ke XML