Bagikan melalui


Gambaran umum kelas XElement

Kelas XElement adalah salah satu kelas dasar dalam LINQ ke XML. Kelas ini mewakili elemen XML. Daftar berikut ini menunjukkan apa yang bisa Anda gunakan untuk kelas ini:

  • Membuat elemen.
  • Mengubah isi dari elemen.
  • Menambahkan, mengubah, atau menghapus elemen turunan.
  • Menambahkan atribut ke elemen.
  • Melakukan serialisasi konten elemen dalam bentuk teks.

Anda juga bisa melakukan interoperasi dengan kelas lain di System.Xml, seperti XmlReader, XmlWriter, dan XslCompiledTransform.

Artikel ini menjelaskan fungsionalitas yang disediakan oleh kelas XElement.

Menyusun pohon XML

Anda dapat menyusun pohon XML dengan cara yang berbeda, termasuk yang berikut ini:

  • Anda dapat menyusun pohon XML dalam kode. Untuk informasi selengkapnya, lihat pohon XML.
  • Anda dapat mengurai XML dari berbagai sumber, termasuk TextReader, file teks, atau sebuah alamat Web (URL). Untuk informasi selengkapnya, lihat Mengurai XML.
  • Anda dapat menggunakan XmlReader untuk mengisi pohon. Untuk informasi selengkapnya, lihat ReadFrom .
  • Jika memiliki modul yang dapat menulis konten ke XmlWriter, Anda dapat menggunakan metode CreateWriter untuk membuat penulis, meneruskan penulis ke modul, lalu menggunakan konten yang ditulis ke XmlWriter untuk mengisi pohon XML.

Contoh berikut membuat pohon. Versi C# menggunakan pembuatan elemen berlapis. Anda bisa menggunakan teknik yang sama dalam Visual Basic, tetapi contoh ini menggunakan harfiah XML.

XElement contacts =
    new XElement("Contacts",
        new XElement("Contact",
            new XElement("Name", "Patrick Hines"),
            new XElement("Phone", "206-555-0144"),
            new XElement("Address",
                new XElement("Street1", "123 Main St"),
                new XElement("City", "Mercer Island"),
                new XElement("State", "WA"),
                new XElement("Postal", "68042")
            )
        )
    );
Dim contacts As XElement = _
    <Contacts>
        <Contact>
            <Name>Patrick Hines</Name>
            <Phone>206-555-0144</Phone>
            <Address>
                <Street1>123 Main St</Street1>
                <City>Mercer Island</City>
                <State>WA</State>
                <Postal>68042</Postal>
            </Address>
        </Contact>
    </Contacts>

Anda juga bisa menggunakan kueri LINQ ke XML untuk mengisi pohon XML, seperti yang ditunjukkan dalam contoh berikut:

XElement srcTree = new XElement("Root",
    new XElement("Element", 1),
    new XElement("Element", 2),
    new XElement("Element", 3),
    new XElement("Element", 4),
    new XElement("Element", 5)
);
XElement xmlTree = new XElement("Root",
    new XElement("Child", 1),
    new XElement("Child", 2),
    from el in srcTree.Elements()
    where (int)el > 2
    select el
);
Console.WriteLine(xmlTree);
Dim srcTree As XElement = _
    <Root>
        <Element>1</Element>
        <Element>2</Element>
        <Element>3</Element>
        <Element>4</Element>
        <Element>5</Element>
    </Root>
Dim xmlTree As XElement = _
    <Root>
        <Child>1</Child>
        <Child>2</Child>
        <%= From el In srcTree.Elements() _
            Where el.Value > 2 _
            Select el %>
    </Root>
Console.WriteLine(xmlTree)

Contoh ini menghasilkan output berikut:

<Root>
  <Child>1</Child>
  <Child>2</Child>
  <Element>3</Element>
  <Element>4</Element>
  <Element>5</Element>
</Root>

Serialisasi pohon XML

Anda bisa melakukan serialisasi pohon XML ke File, TextWriter, atau XmlWriter.

Untuk informasi selengkapnya, lihat Melakukan serialisasi pohon XML.

Mengambil data XML melalui metode sumbu

Anda bisa menggunakan metode sumbu untuk mengambil atribut, elemen turunan, elemen keturunan, serta elemen leluhur. Kueri LINQ ke XML beroperasi pada metode sumbu, serta menyediakan beberapa cara yang fleksibel dan kuat untuk menavigasi dan memproses pohon XML.

Untuk informasi selengkapnya, lihat gambaran umum sumbu LINQ ke XML.

Mengkueri pohon XML

Anda bisa menulis LINQ ke kueri XML yang mengekstrak data dari pohon XML.

Untuk informasi selengkapnya, lihat Gambaran umum XML Kueri.

Memodifikasi pohon XML

Anda bisa memodifikasi elemen dengan cara yang berbeda, termasuk mengubah konten atau atributnya. Anda juga bisa menghapus elemen dari induknya.

Untuk informasi selengkapnya, lihat Memodifikasi pohon XML.

Lihat juga