XElement Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mewakili elemen XML. Lihat Gambaran Umum Kelas XElement dan bagian Keterangan di halaman ini untuk informasi dan contoh penggunaan.
public ref class XElement : System::Xml::Linq::XContainer, System::Xml::Serialization::IXmlSerializable
public ref class XElement : System::Xml::Linq::XContainer
public class XElement : System.Xml.Linq.XContainer, System.Xml.Serialization.IXmlSerializable
public class XElement : System.Xml.Linq.XContainer
type XElement = class
inherit XContainer
interface IXmlSerializable
type XElement = class
inherit XContainer
Public Class XElement
Inherits XContainer
Implements IXmlSerializable
Public Class XElement
Inherits XContainer
- Warisan
- Penerapan
Contoh
Contoh berikut membuat pohon XML. Konten elemen baru berasal dari kueri LINQ.
XElement xmlTree1 = new XElement("Root",
new XElement("Child1", 1),
new XElement("Child2", 2),
new XElement("Child3", 3),
new XElement("Child4", 4),
new XElement("Child5", 5),
new XElement("Child6", 6)
);
XElement xmlTree2 = new XElement("Root",
from el in xmlTree1.Elements()
where((int)el >= 3 && (int)el <= 5)
select el
);
Console.WriteLine(xmlTree2);
Dim xmlTree1 As XElement = _
<Root>
<Child1>1</Child1>
<Child2>2</Child2>
<Child3>3</Child3>
<Child4>4</Child4>
<Child5>5</Child5>
<Child6>6</Child6>
</Root>
Dim xmlTree2 As XElement = _
<Root>
<%= From el In xmlTree1.Elements() _
Where el.Value >= 3 And el.Value <= 5 _
Select el %>
</Root>
Console.WriteLine(xmlTree2)
Contoh ini mencetak output berikut:
<Root>
<Child3>3</Child3>
<Child4>4</Child4>
<Child5>5</Child5>
</Root>
Berikut ini adalah contoh yang sama, tetapi dalam hal ini XML berada di namespace layanan. Untuk informasi selengkapnya, lihat Bekerja dengan Namespace XML.
XNamespace aw = "http://www.adventure-works.com";
XElement xmlTree1 = new XElement(aw + "Root",
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),
new XElement(aw + "Child6", 6)
);
XElement xmlTree2 = new XElement(aw + "Root",
from el in xmlTree1.Elements()
where((int)el >= 3 && (int)el <= 5)
select el
);
Console.WriteLine(xmlTree2);
Imports <xmlns="http://www.adventure-works.com">
Module Module1
Sub Main()
Dim xmlTree1 As XElement = _
<Root>
<Child1>1</Child1>
<Child2>2</Child2>
<Child3>3</Child3>
<Child4>4</Child4>
<Child5>5</Child5>
<Child6>6</Child6>
</Root>
Dim xmlTree2 As XElement = _
<Root>
<%= From el In xmlTree1.Elements() _
Where el.Value >= 3 And el.Value <= 5 _
Select el %>
</Root>
Console.WriteLine(xmlTree2)
End SUb
End Module
Contoh ini mencetak output berikut:
<Root xmlns="http://www.adventure-works.com">
<Child3>3</Child3>
<Child4>4</Child4>
<Child5>5</Child5>
</Root>
Keterangan
Kelas ini mewakili elemen XML, konstruksi XML dasar. Lihat Gambaran Umum Kelas XElement untuk informasi penggunaan lainnya.
Elemen memiliki XName, secara opsional satu atau beberapa atribut, dan dapat secara opsional berisi konten (untuk informasi selengkapnya, lihat Nodes).
Dapat XElement berisi jenis konten berikut:
Untuk detail tentang konten yang XElementvalid dari , lihat Konten Valid XElement dan Objek XDocument.
XElement berasal dari XContainer, yang berasal dari XNode.
Beberapa XElement metode dapat digunakan dari XAML. Untuk informasi selengkapnya, lihat LINQ ke Properti Dinamis XML.
Konstruktor
XElement(XElement) |
Menginisialisasi instans XElement baru kelas dari objek lain XElement . |
XElement(XName) |
Menginisialisasi instans XElement baru kelas dengan nama yang ditentukan. |
XElement(XName, Object) |
Menginisialisasi instans XElement baru kelas dengan nama dan konten yang ditentukan. |
XElement(XName, Object[]) |
Menginisialisasi instans XElement baru kelas dengan nama dan konten yang ditentukan. |
XElement(XStreamingElement) |
Menginisialisasi instans XElement baru kelas dari XStreamingElement objek. |
Properti
BaseUri |
Mendapatkan URI dasar untuk ini XObject. (Diperoleh dari XObject) |
Document |
XDocument Mendapatkan untuk iniXObject. (Diperoleh dari XObject) |
EmptySequence |
Mendapatkan koleksi elemen kosong. |
FirstAttribute |
Mendapatkan atribut pertama dari elemen ini. |
FirstNode |
Mendapatkan simpul anak pertama dari simpul ini. (Diperoleh dari XContainer) |
HasAttributes |
Mendapatkan nilai yang menunjukkan apakah elemen ini memiliki setidaknya satu atribut. |
HasElements |
Mendapatkan nilai yang menunjukkan apakah elemen ini memiliki setidaknya satu elemen anak. |
IsEmpty |
Mendapatkan nilai yang menunjukkan apakah elemen ini tidak berisi konten. |
LastAttribute |
Mendapatkan atribut terakhir dari elemen ini. |
LastNode |
Mendapatkan simpul anak terakhir dari simpul ini. (Diperoleh dari XContainer) |
Name |
Mendapatkan atau mengatur nama elemen ini. |
NextNode |
Mendapatkan simpul saudara berikutnya dari simpul ini. (Diperoleh dari XNode) |
NodeType |
Mendapatkan jenis node untuk simpul ini. |
Parent |
Mendapatkan induk XElement dari ini XObject. (Diperoleh dari XObject) |
PreviousNode |
Mendapatkan simpul saudara kandung sebelumnya dari simpul ini. (Diperoleh dari XNode) |
Value |
Mendapatkan atau mengatur konten teks yang digabungkan dari elemen ini. |
Metode
Add(Object) |
Menambahkan konten yang ditentukan sebagai turunan dari ini XContainer. (Diperoleh dari XContainer) |
Add(Object[]) |
Menambahkan konten yang ditentukan sebagai turunan dari ini XContainer. (Diperoleh dari XContainer) |
AddAfterSelf(Object) |
Menambahkan konten yang ditentukan segera setelah simpul ini. (Diperoleh dari XNode) |
AddAfterSelf(Object[]) |
Menambahkan konten yang ditentukan segera setelah simpul ini. (Diperoleh dari XNode) |
AddAnnotation(Object) |
Menambahkan objek ke daftar anotasi ini XObject. (Diperoleh dari XObject) |
AddBeforeSelf(Object) |
Menambahkan konten yang ditentukan segera sebelum simpul ini. (Diperoleh dari XNode) |
AddBeforeSelf(Object[]) |
Menambahkan konten yang ditentukan segera sebelum simpul ini. (Diperoleh dari XNode) |
AddFirst(Object) |
Menambahkan isi yang ditentukan sebagai turunan pertama dari dokumen atau elemen ini. (Diperoleh dari XContainer) |
AddFirst(Object[]) |
Menambahkan isi yang ditentukan sebagai turunan pertama dari dokumen atau elemen ini. (Diperoleh dari XContainer) |
Ancestors() |
Mengembalikan kumpulan elemen leluhur dari simpul ini. (Diperoleh dari XNode) |
Ancestors(XName) |
Mengembalikan kumpulan yang difilter dari elemen leluhur dari simpul ini. Hanya elemen yang memiliki pencocokan XName yang disertakan dalam koleksi. (Diperoleh dari XNode) |
AncestorsAndSelf() |
Mengembalikan kumpulan elemen yang berisi elemen ini, dan leluhur elemen ini. |
AncestorsAndSelf(XName) |
Mengembalikan kumpulan elemen yang difilter yang berisi elemen ini, dan leluhur elemen ini. Hanya elemen yang memiliki pencocokan XName yang disertakan dalam koleksi. |
Annotation(Type) |
Mendapatkan objek anotasi pertama dari jenis yang ditentukan dari ini XObject. (Diperoleh dari XObject) |
Annotation<T>() |
Mendapatkan objek anotasi pertama dari jenis yang ditentukan dari ini XObject. (Diperoleh dari XObject) |
Annotations(Type) |
Mendapatkan kumpulan anotasi dari jenis yang ditentukan untuk ini XObject. (Diperoleh dari XObject) |
Annotations<T>() |
Mendapatkan kumpulan anotasi dari jenis yang ditentukan untuk ini XObject. (Diperoleh dari XObject) |
Attribute(XName) |
Mengembalikan XAttribute dari ini XElement yang memiliki yang ditentukan XName. |
Attributes() |
Mengembalikan kumpulan atribut elemen ini. |
Attributes(XName) |
Mengembalikan kumpulan atribut yang difilter dari elemen ini. Hanya atribut yang memiliki pencocokan XName yang disertakan dalam koleksi. |
CreateReader() |
XmlReader Membuat untuk simpul ini. (Diperoleh dari XNode) |
CreateReader(ReaderOptions) |
XmlReader Membuat dengan opsi yang ditentukan oleh |
CreateWriter() |
Membuat yang XmlWriter dapat digunakan untuk menambahkan simpul ke XContainer. (Diperoleh dari XContainer) |
DescendantNodes() |
Mengembalikan kumpulan simpul turunan untuk dokumen atau elemen ini, dalam urutan dokumen. (Diperoleh dari XContainer) |
DescendantNodesAndSelf() |
Mengembalikan kumpulan simpul yang berisi elemen ini, dan semua simpul turunan dari elemen ini, dalam urutan dokumen. |
Descendants() |
Mengembalikan kumpulan elemen turunan untuk dokumen atau elemen ini, dalam urutan dokumen. (Diperoleh dari XContainer) |
Descendants(XName) |
Mengembalikan kumpulan elemen turunan yang difilter untuk dokumen atau elemen ini, dalam urutan dokumen. Hanya elemen yang memiliki pencocokan XName yang disertakan dalam koleksi. (Diperoleh dari XContainer) |
DescendantsAndSelf() |
Mengembalikan kumpulan elemen yang berisi elemen ini, dan semua elemen turunan dari elemen ini, dalam urutan dokumen. |
DescendantsAndSelf(XName) |
Mengembalikan kumpulan elemen yang difilter yang berisi elemen ini, dan semua elemen turunan elemen ini, dalam urutan dokumen. Hanya elemen yang memiliki pencocokan XName yang disertakan dalam koleksi. |
Element(XName) |
Mendapatkan elemen turunan pertama (dalam urutan dokumen) dengan yang ditentukan XName. (Diperoleh dari XContainer) |
Elements() |
Mengembalikan kumpulan elemen anak dari elemen atau dokumen ini, dalam urutan dokumen. (Diperoleh dari XContainer) |
Elements(XName) |
Mengembalikan kumpulan elemen turunan yang difilter dari elemen atau dokumen ini, dalam urutan dokumen. Hanya elemen yang memiliki pencocokan XName yang disertakan dalam koleksi. (Diperoleh dari XContainer) |
ElementsAfterSelf() |
Mengembalikan kumpulan elemen saudara setelah simpul ini, dalam urutan dokumen. (Diperoleh dari XNode) |
ElementsAfterSelf(XName) |
Mengembalikan kumpulan elemen saudara yang difilter setelah simpul ini, dalam urutan dokumen. Hanya elemen yang memiliki pencocokan XName yang disertakan dalam koleksi. (Diperoleh dari XNode) |
ElementsBeforeSelf() |
Mengembalikan kumpulan elemen saudara sebelum simpul ini, dalam urutan dokumen. (Diperoleh dari XNode) |
ElementsBeforeSelf(XName) |
Mengembalikan kumpulan elemen saudara yang difilter sebelum simpul ini, dalam urutan dokumen. Hanya elemen yang memiliki pencocokan XName yang disertakan dalam koleksi. (Diperoleh dari XNode) |
Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
GetDefaultNamespace() |
Mendapatkan default XNamespace dari ini XElement. |
GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
GetNamespaceOfPrefix(String) |
Mendapatkan namespace layanan yang terkait dengan awalan tertentu untuk ini XElement. |
GetPrefixOfNamespace(XNamespace) |
Mendapatkan awalan yang terkait dengan namespace layanan untuk ini XElement. |
GetType() |
Mendapatkan dari instans Type saat ini. (Diperoleh dari Object) |
IsAfter(XNode) |
Menentukan apakah simpul saat ini muncul setelah simpul tertentu dalam hal urutan dokumen. (Diperoleh dari XNode) |
IsBefore(XNode) |
Menentukan apakah simpul saat ini muncul sebelum simpul tertentu dalam hal urutan dokumen. (Diperoleh dari XNode) |
Load(Stream) |
Membuat instans baru XElement dengan menggunakan aliran yang ditentukan. |
Load(Stream, LoadOptions) |
Membuat instans baru XElement dengan menggunakan aliran yang ditentukan, secara opsional mempertahankan ruang kosong, mengatur URI dasar, dan mempertahankan informasi baris. |
Load(String) |
XElement Memuat dari file. |
Load(String, LoadOptions) |
XElement Memuat dari file, secara opsional mempertahankan spasi kosong, mengatur URI dasar, dan mempertahankan informasi baris. |
Load(TextReader) |
XElement Memuat dari TextReader. |
Load(TextReader, LoadOptions) |
XElement Memuat dari TextReader, secara opsional mempertahankan ruang kosong dan mempertahankan informasi garis. |
Load(XmlReader) | |
Load(XmlReader, LoadOptions) |
XElement Memuat dari XmlReader, secara opsional mempertahankan ruang kosong, mengatur URI dasar, dan mempertahankan informasi garis. |
LoadAsync(Stream, LoadOptions, CancellationToken) |
Secara asinkron membuat yang baru XElement dan menginisialisasi pohon XML yang mendasarinya menggunakan aliran yang ditentukan, secara opsional mempertahankan spasi kosong. |
LoadAsync(TextReader, LoadOptions, CancellationToken) |
Secara asinkron membuat yang baru XElement dan menginisialisasi pohon XML yang mendasarinya menggunakan pembaca teks yang ditentukan, secara opsional mempertahankan spasi kosong. |
LoadAsync(XmlReader, LoadOptions, CancellationToken) |
Secara asinkron membuat yang baru XElement dan menginisialisasi pohon XML yang mendasarinya menggunakan pembaca XML yang ditentukan, secara opsional mempertahankan spasi kosong. |
MemberwiseClone() |
Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object) |
Nodes() |
Mengembalikan kumpulan simpul anak dari elemen atau dokumen ini, dalam urutan dokumen. (Diperoleh dari XContainer) |
NodesAfterSelf() |
Mengembalikan kumpulan simpul saudara setelah simpul ini, dalam urutan dokumen. (Diperoleh dari XNode) |
NodesBeforeSelf() |
Mengembalikan kumpulan simpul saudara sebelum simpul ini, dalam urutan dokumen. (Diperoleh dari XNode) |
Parse(String) |
XElement Muat dari string yang berisi XML. |
Parse(String, LoadOptions) |
XElement Muat dari string yang berisi XML, secara opsional mempertahankan spasi kosong dan mempertahankan informasi baris. |
Remove() |
Menghapus simpul ini dari induknya. (Diperoleh dari XNode) |
RemoveAll() |
Menghapus simpul dan atribut dari ini XElement. |
RemoveAnnotations(Type) |
Menghapus anotasi dari jenis yang ditentukan dari ini XObject. (Diperoleh dari XObject) |
RemoveAnnotations<T>() |
Menghapus anotasi dari jenis yang ditentukan dari ini XObject. (Diperoleh dari XObject) |
RemoveAttributes() |
Menghapus atribut dari ini XElement. |
RemoveNodes() |
Menghapus simpul anak dari dokumen atau elemen ini. (Diperoleh dari XContainer) |
ReplaceAll(Object) |
Mengganti simpul anak dan atribut elemen ini dengan konten yang ditentukan. |
ReplaceAll(Object[]) |
Mengganti simpul anak dan atribut elemen ini dengan konten yang ditentukan. |
ReplaceAttributes(Object) |
Mengganti atribut elemen ini dengan konten yang ditentukan. |
ReplaceAttributes(Object[]) |
Mengganti atribut elemen ini dengan konten yang ditentukan. |
ReplaceNodes(Object) |
Mengganti simpul turunan dari dokumen atau elemen ini dengan isi yang ditentukan. (Diperoleh dari XContainer) |
ReplaceNodes(Object[]) |
Mengganti simpul turunan dari dokumen atau elemen ini dengan isi yang ditentukan. (Diperoleh dari XContainer) |
ReplaceWith(Object) |
Mengganti simpul ini dengan isi yang ditentukan. (Diperoleh dari XNode) |
ReplaceWith(Object[]) |
Mengganti simpul ini dengan isi yang ditentukan. (Diperoleh dari XNode) |
Save(Stream) | |
Save(Stream, SaveOptions) |
Mengeluarkan ini XElement ke perilaku pemformatan yang ditentukan Stream, secara opsional. |
Save(String) |
Serialisasi elemen ini ke file. |
Save(String, SaveOptions) |
Serialisasi elemen ini ke file, secara opsional menonaktifkan pemformatan. |
Save(TextWriter) |
Serialisasi elemen ini ke TextWriter. |
Save(TextWriter, SaveOptions) |
Serialisasi elemen ini ke TextWriter, secara opsional menonaktifkan pemformatan. |
Save(XmlWriter) |
Serialisasi elemen ini ke XmlWriter. |
SaveAsync(Stream, SaveOptions, CancellationToken) | |
SaveAsync(TextWriter, SaveOptions, CancellationToken) |
Secara asinkron menghasilkan ini XElement ke TextWriter. |
SaveAsync(XmlWriter, CancellationToken) | |
SetAttributeValue(XName, Object) |
Mengatur nilai atribut, menambahkan atribut, atau menghapus atribut. |
SetElementValue(XName, Object) |
Mengatur nilai elemen anak, menambahkan elemen anak, atau menghapus elemen anak. |
SetValue(Object) |
Mengatur nilai elemen ini. |
ToString() |
Mengembalikan XML inden untuk simpul ini. (Diperoleh dari XNode) |
ToString(SaveOptions) |
Mengembalikan XML untuk simpul ini, secara opsional menonaktifkan pemformatan. (Diperoleh dari XNode) |
WriteTo(XmlWriter) |
Tulis elemen ini ke XmlWriter. |
WriteToAsync(XmlWriter, CancellationToken) |
Secara asinkron menulis ini XElement ke penulis yang ditentukan. |
WriteToAsync(XmlWriter, CancellationToken) |
Menulis simpul saat ini ke XmlWriter. (Diperoleh dari XNode) |
Operator
Acara
Changed |
Dimunculkan ketika ini XObject atau salah satu keturunannya telah berubah. (Diperoleh dari XObject) |
Changing |
Dimunculkan ketika ini XObject atau salah satu keturunannya akan berubah. (Diperoleh dari XObject) |
Implementasi Antarmuka Eksplisit
IXmlLineInfo.HasLineInfo() |
Mendapatkan nilai yang menunjukkan apakah ini XObject memiliki informasi baris atau tidak. (Diperoleh dari XObject) |
IXmlLineInfo.LineNumber |
Mendapatkan nomor baris yang dilaporkan mendasar XmlReader untuk ini XObject. (Diperoleh dari XObject) |
IXmlLineInfo.LinePosition |
Mendapatkan posisi baris yang dilaporkan mendasar XmlReader untuk ini XObject. (Diperoleh dari XObject) |
IXmlSerializable.GetSchema() |
Mendapatkan definisi skema XML yang menjelaskan representasi XML objek ini. |
IXmlSerializable.ReadXml(XmlReader) |
Menghasilkan objek dari representasi XML-nya. |
IXmlSerializable.WriteXml(XmlWriter) |
Mengonversi objek menjadi representasi XML-nya. |
Metode Ekstensi
GetSchemaInfo(XElement) |
Mendapatkan infoset pasca-validasi skema (PSVI) dari elemen yang divalidasi. |
Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler) |
Metode ini memvalidasi bahwa XElement sub-pohon sesuai dengan yang ditentukan XmlSchemaObject dan XmlSchemaSet. |
Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler, Boolean) |
Memvalidasi bahwa XElement sub-pohon sesuai dengan yang ditentukan XmlSchemaObject dan XmlSchemaSet, secara opsional mengisi pohon XML dengan infoset pasca-validasi skema (PSVI). |
CreateNavigator(XNode) |
XPathNavigator Membuat untuk XNode. |
CreateNavigator(XNode, XmlNameTable) |
XPathNavigator Membuat untuk XNode. memungkinkan XmlNameTable pemrosesan ekspresi JalurX yang lebih efisien. |
XPathEvaluate(XNode, String) |
Mengevaluasi ekspresi JalurX. |
XPathEvaluate(XNode, String, IXmlNamespaceResolver) |
Mengevaluasi ekspresi JalurX, menyelesaikan awalan namespace menggunakan yang ditentukan IXmlNamespaceResolver. |
XPathSelectElement(XNode, String) |
XElement Memilih menggunakan ekspresi JalurX. |
XPathSelectElement(XNode, String, IXmlNamespaceResolver) |
XElement Memilih menggunakan ekspresi JalurX, menyelesaikan awalan namespace menggunakan yang ditentukan IXmlNamespaceResolver. |
XPathSelectElements(XNode, String) |
Memilih kumpulan elemen menggunakan ekspresi JalurX. |
XPathSelectElements(XNode, String, IXmlNamespaceResolver) |
Memilih kumpulan elemen menggunakan ekspresi JalurX, menyelesaikan awalan namespace menggunakan yang ditentukan IXmlNamespaceResolver. |
ToXPathNavigable(XNode) |
Mengembalikan aksesor yang memungkinkan Anda menavigasi dan mengedit yang ditentukan XNode. |