XDocument Kelas

Definisi

Ruang nama:

System.Xml.Linq

Rakitan:

netstandard.dll, System.Xml.XDocument.dll

Sumber:

XDocument.cs

Mewakili dokumen XML. Untuk komponen dan penggunaan XDocument objek, lihat Gambaran Umum Kelas XDocument.

public ref class XDocument : System::Xml::Linq::XContainer

public class XDocument : System.Xml.Linq.XContainer

type XDocument = class
    inherit XContainer

Public Class XDocument
Inherits XContainer

Warisan

Object

XObject

XNode

XContainer

XDocument

Contoh

Contoh berikut membuat dokumen, lalu menambahkan komentar dan elemen ke dalamnya. Kemudian menyusun dokumen lain menggunakan hasil kueri.

XDocument srcTree = new XDocument(
    new XComment("This is a comment"),
    new XElement("Root",
        new XElement("Child1", "data1"),
        new XElement("Child2", "data2"),
        new XElement("Child3", "data3"),
        new XElement("Child2", "data4"),
        new XElement("Info5", "info5"),
        new XElement("Info6", "info6"),
        new XElement("Info7", "info7"),
        new XElement("Info8", "info8")
    )
);

XDocument doc = new XDocument(
    new XComment("This is a comment"),
    new XElement("Root",
        from el in srcTree.Element("Root").Elements()
        where ((string)el).StartsWith("data")
        select el
    )
);
Console.WriteLine(doc);

Dim srcTree As XDocument = _
    <?xml version="1.0" encoding="utf-8" standalone="yes"?>
        <!--This is a comment-->
        <Root>
            <Child1>data1</Child1>
            <Child2>data2</Child2>
            <Child3>data3</Child3>
            <Child2>data4</Child2>
            <Info5>info5</Info5>
            <Info6>info6</Info6>
            <Info7>info7</Info7>
            <Info8>info8</Info8>
        </Root>
Dim doc As XDocument = _
    <?xml version="1.0" encoding="utf-8" standalone="yes"?>
        <!--This is a comment-->
        <Root>
            <%= From el In srcTree.<Root>.Elements _
                Where CStr(el).StartsWith("data") _
                Select el %>
        </Root>
Console.WriteLine(doc)

Contoh ini menghasilkan output berikut:

<!--This is a comment-->
<Root>
  <Child1>data1</Child1>
  <Child2>data2</Child2>
  <Child3>data3</Child3>
  <Child2>data4</Child2>
</Root>

Keterangan

Untuk detail tentang konten yang XDocumentvalid dari , lihat Konten Valid Objek XElement dan XDocument.

Konstruktor

Nama	Deskripsi
XDocument()	Menginisialisasi instans baru dari kelas XDocument.
XDocument(Object[])	Menginisialisasi instans XDocument baru kelas dengan konten yang ditentukan.
XDocument(XDeclaration, Object[])	Menginisialisasi instans XDocument baru kelas dengan konten dan yang ditentukan XDeclaration .
XDocument(XDocument)	Menginisialisasi instans XDocument baru kelas dari objek yang ada XDocument .

Properti

Nama	Deskripsi
BaseUri	Mendapatkan URI dasar untuk ini XObject. (Diperoleh dari XObject)
Declaration	Mendapatkan atau mengatur deklarasi XML untuk dokumen ini.
Document	XDocument Mendapatkan untuk iniXObject. (Diperoleh dari XObject)
DocumentType	Mendapatkan Definisi Tipe Dokumen (DTD) untuk dokumen ini.
FirstNode	Mendapatkan simpul anak pertama dari simpul ini. (Diperoleh dari XContainer)
LastNode	Mendapatkan simpul anak terakhir dari simpul ini. (Diperoleh dari XContainer)
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)
Root	Mendapatkan elemen akar Pohon XML untuk dokumen ini.

Metode

Nama	Deskripsi
Add(Object)	Menambahkan konten yang ditentukan sebagai turunan dari .XContainer (Diperoleh dari XContainer)
Add(Object[])	Menambahkan konten yang ditentukan sebagai turunan dari .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 XName yang cocok yang disertakan dalam koleksi. (Diperoleh dari XNode)
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)
CreateReader()	XmlReader Membuat untuk simpul ini. (Diperoleh dari XNode)
CreateReader(ReaderOptions)	XmlReader Membuat dengan opsi yang ditentukan oleh readerOptions parameter . (Diperoleh dari XNode)
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)
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 XName yang cocok yang disertakan dalam koleksi. (Diperoleh dari XContainer)
Element(XName)	Mendapatkan elemen turunan pertama (dalam urutan dokumen) dengan yang ditentukan XName. (Diperoleh dari XContainer)
Elements()	Mengembalikan kumpulan elemen turunan 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 XName yang cocok 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 XName yang cocok 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 XName yang cocok yang disertakan dalam koleksi. (Diperoleh dari XNode)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
IsAfter(XNode)	Menentukan apakah simpul saat ini muncul setelah node 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, LoadOptions)	Membuat instans baru XDocument dengan menggunakan aliran yang ditentukan, secara opsional mempertahankan ruang kosong, mengatur URI dasar, dan mempertahankan informasi baris.
Load(Stream)	Membuat instans baru XDocument dengan menggunakan aliran yang ditentukan.
Load(String, LoadOptions)	Membuat baru XDocument dari file, secara opsional mempertahankan spasi kosong, mengatur URI dasar, dan mempertahankan informasi baris.
Load(String)	Membuat baru XDocument dari file.
Load(TextReader, LoadOptions)	Membuat baru XDocument dari TextReader, secara opsional mempertahankan spasi kosong, mengatur URI dasar, dan mempertahankan informasi baris.
Load(TextReader)	Membuat baru XDocument dari TextReader.
Load(XmlReader, LoadOptions)	XDocument Memuat dari XmlReader, secara opsional mengatur URI dasar, dan mempertahankan informasi baris.
Load(XmlReader)	Membuat baru XDocument dari XmlReader.
LoadAsync(Stream, LoadOptions, CancellationToken)	Secara asinkron membuat pohon XML baru XDocument dan menginisialisasi pohon XML yang mendasarinya dari aliran yang ditentukan, secara opsional mempertahankan spasi kosong.
LoadAsync(TextReader, LoadOptions, CancellationToken)	Membuat pohon XML baru XDocument dan menginisialisasi pohon XML yang mendasarinya menggunakan parameter yang ditentukan TextReader , secara opsional mempertahankan spasi kosong.
LoadAsync(XmlReader, LoadOptions, CancellationToken)	Membuat baru XDocument yang berisi konten dari yang ditentukan XmlReader.
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (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, LoadOptions)	Membuat baru XDocument dari string, secara opsional mempertahankan spasi kosong, mengatur URI dasar, dan mempertahankan informasi baris.
Parse(String)	Membuat baru XDocument dari string.
Remove()	Menghapus simpul ini dari induknya. (Diperoleh dari XNode)
RemoveAnnotations(Type)	Menghapus anotasi jenis yang ditentukan dari ini XObject. (Diperoleh dari XObject)
RemoveAnnotations<T>()	Menghapus anotasi jenis yang ditentukan dari ini XObject. (Diperoleh dari XObject)
RemoveNodes()	Menghapus simpul anak dari dokumen atau elemen ini. (Diperoleh dari XContainer)
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, SaveOptions)	Menghasilkan ini XDocument ke perilaku pemformatan yang ditentukan Stream, secara opsional.
Save(Stream)	Output ini XDocument ke yang ditentukan Stream.
Save(String, SaveOptions)	Serialkan ini XDocument ke file, secara opsional menonaktifkan pemformatan.
Save(String)	Menserialisasikan ini XDocument ke file, menimpa file yang ada, jika ada.
Save(TextWriter, SaveOptions)	Menserialisasikan ini XDocument ke TextWriter, secara opsional menonaktifkan pemformatan.
Save(TextWriter)	Menserialisasikan ini XDocument ke TextWriter.
Save(XmlWriter)	Menserialisasikan ini XDocument ke XmlWriter.
SaveAsync(Stream, SaveOptions, CancellationToken)	Keluarkan ini XDocument ke Stream.
SaveAsync(TextWriter, SaveOptions, CancellationToken)	Menulis ini XDocument ke TextWriter.
SaveAsync(XmlWriter, CancellationToken)	Menulis ini XDocument ke XmlWriter.
ToString()	Mengembalikan XML yang diindentasi untuk simpul ini. (Diperoleh dari XNode)
ToString(SaveOptions)	Mengembalikan XML untuk simpul ini, secara opsional menonaktifkan pemformatan. (Diperoleh dari XNode)
WriteTo(XmlWriter)	Tulis dokumen ini ke XmlWriter.
WriteToAsync(XmlWriter, CancellationToken)	Menulis pohon XML mendasar XDocument ini ke yang ditentukan XmlWriter.

Acara

Nama	Deskripsi
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

Nama	Deskripsi
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 yang mendasar XmlReader untuk ini XObject. (Diperoleh dari XObject)

Metode Ekstensi

Nama	Deskripsi
CreateNavigator(XNode, XmlNameTable)	XPathNavigator Membuat untuk XNode. memungkinkan XmlNameTable pemrosesan ekspresi XPath yang lebih efisien.
CreateNavigator(XNode)	XPathNavigator Membuat untuk XNode.
ToXPathNavigable(XNode)	Mengembalikan aksesor yang memungkinkan Anda menavigasi dan mengedit XNode.
Validate(XDocument, XmlSchemaSet, ValidationEventHandler, Boolean)	Memvalidasi bahwa XDocument sesuai dengan XSD dalam XmlSchemaSet, secara opsional mengisi pohon XML dengan infoset validasi pasca-skema (PSVI).
Validate(XDocument, XmlSchemaSet, ValidationEventHandler)	Metode ini memvalidasi bahwa sesuai XDocument dengan XSD dalam XmlSchemaSet.
XPathEvaluate(XNode, String, IXmlNamespaceResolver)	Mengevaluasi ekspresi XPath, menyelesaikan awalan namespace menggunakan yang ditentukan IXmlNamespaceResolver.
XPathEvaluate(XNode, String)	Mengevaluasi ekspresi XPath.
XPathSelectElement(XNode, String, IXmlNamespaceResolver)	XElement Memilih menggunakan ekspresi XPath, menyelesaikan awalan namespace menggunakan yang ditentukan IXmlNamespaceResolver.
XPathSelectElement(XNode, String)	XElement Memilih menggunakan ekspresi XPath.
XPathSelectElements(XNode, String, IXmlNamespaceResolver)	Memilih kumpulan elemen menggunakan ekspresi XPath, menyelesaikan awalan namespace menggunakan yang ditentukan IXmlNamespaceResolver.
XPathSelectElements(XNode, String)	Memilih kumpulan elemen menggunakan ekspresi XPath.

Lihat juga

• XNamespace
• XDeclaration
• XElement
• XNode
• Gambaran umum LINQ ke XML
• Gambaran Umum Kelas XDocument