XmlReader Kelas

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlReader.cs

Mewakili pembaca yang menyediakan akses cepat, non-cache, dan hanya-terusan ke data XML.

public ref class XmlReader abstract : IDisposable

public abstract class XmlReader : IDisposable

type XmlReader = class
    interface IDisposable

Public MustInherit Class XmlReader
Implements IDisposable

Warisan

Object

XmlReader

Turunan

System.Xml.XmlDictionaryReader

System.Xml.XmlNodeReader

System.Xml.XmlTextReader

System.Xml.XmlValidatingReader

Penerapan

IDisposable

Contoh

Contoh kode berikut menunjukkan cara menggunakan API asinkron untuk mengurai XML.

async Task TestReader(System.IO.Stream stream)
{
    XmlReaderSettings settings = new XmlReaderSettings();
    settings.Async = true;

    using (XmlReader reader = XmlReader.Create(stream, settings))
    {
        while (await reader.ReadAsync())
        {
            switch (reader.NodeType)
            {
                case XmlNodeType.Element:
                    Console.WriteLine("Start Element {0}", reader.Name);
                    break;
                case XmlNodeType.Text:
                    Console.WriteLine("Text Node: {0}",
                             await reader.GetValueAsync());
                    break;
                case XmlNodeType.EndElement:
                    Console.WriteLine("End Element {0}", reader.Name);
                    break;
                default:
                    Console.WriteLine("Other node {0} with value {1}",
                                    reader.NodeType, reader.Value);
                    break;
            }
        }
    }
}

Public Async Function TestReader(stream As System.IO.Stream) As Task
    Dim settings As New XmlReaderSettings()
    settings.Async = True

    Using reader As XmlReader = XmlReader.Create(stream, settings)
        While (Await reader.ReadAsync())
            Select Case (reader.NodeType)
                Case XmlNodeType.Element
                    Console.WriteLine("Start Element {0}", reader.Name)
                Case XmlNodeType.Text
                    Console.WriteLine("Text Node: {0}",
                             Await reader.GetValueAsync())
                Case XmlNodeType.EndElement
                    Console.WriteLine("End Element {0}", reader.Name)
                Case Else
                    Console.WriteLine("Other node {0} with value {1}",
                                    reader.NodeType, reader.Value)
            End Select
        End While
    End Using
End Function

Keterangan

Untuk informasi selengkapnya tentang API ini, lihat Keterangan API Tambahan untuk XmlReader.

Konstruktor

Nama	Deskripsi
XmlReader()	Menginisialisasi instans baru dari kelas XmlReader.

Properti

Nama	Deskripsi
AttributeCount	Ketika ditimpa di kelas turunan, mendapatkan jumlah atribut pada simpul saat ini.
BaseURI	Ketika ditimpa di kelas turunan, mendapatkan URI dasar simpul saat ini.
CanReadBinaryContent	Mendapatkan nilai yang menunjukkan apakah XmlReader mengimplementasikan metode baca konten biner.
CanReadValueChunk	Mendapatkan nilai yang menunjukkan apakah mengimplementasikan XmlReaderReadValueChunk(Char[], Int32, Int32) metode .
CanResolveEntity	Mendapatkan nilai yang menunjukkan apakah pembaca ini dapat mengurai dan menyelesaikan entitas.
Depth	Saat ditimpa di kelas turunan, mendapatkan kedalaman simpul saat ini dalam dokumen XML.
EOF	Saat ditimpa di kelas turunan, mendapatkan nilai yang menunjukkan apakah pembaca diposisikan di akhir aliran.
HasAttributes	Mendapatkan nilai yang menunjukkan apakah simpul saat ini memiliki atribut apa pun.
HasValue	Ketika ditimpa dalam kelas turunan, mendapatkan nilai yang menunjukkan apakah simpul saat ini dapat memiliki Value.
IsDefault	Ketika ditimpa dalam kelas turunan, mendapatkan nilai yang menunjukkan apakah simpul saat ini adalah atribut yang dihasilkan dari nilai default yang ditentukan dalam DTD atau skema.
IsEmptyElement	Ketika ditimpa dalam kelas turunan, mendapatkan nilai yang menunjukkan apakah node saat ini adalah elemen kosong (misalnya, <MyElement/>).
Item[Int32]	Saat ditimpa dalam kelas turunan, mendapatkan nilai atribut dengan indeks yang ditentukan.
Item[String, String]	Ketika ditimpa dalam kelas turunan, mendapatkan nilai atribut dengan yang ditentukan LocalName dan NamespaceURI.
Item[String]	Ketika ditimpa dalam kelas turunan, mendapatkan nilai atribut dengan yang ditentukan Name.
LocalName	Ketika ditimpa di kelas turunan, mendapatkan nama lokal simpul saat ini.
Name	Ketika ditimpa di kelas turunan, mendapatkan nama yang memenuhi syarat dari node saat ini.
NamespaceURI	Ketika ditimpa dalam kelas turunan, mendapatkan URI namespace (seperti yang didefinisikan dalam spesifikasi Namespace W3C) dari simpul tempat pembaca diposisikan.
NameTable	Ketika ditimpa dalam kelas turunan, mendapatkan yang XmlNameTable terkait dengan implementasi ini.
NodeType	Ketika ditimpa di kelas turunan, mendapatkan jenis node saat ini.
Prefix	Ketika ditimpa di kelas turunan, mendapatkan awalan namespace yang terkait dengan simpul saat ini.
QuoteChar	Saat ditimpa dalam kelas turunan, mendapatkan karakter tanda kutip yang digunakan untuk mengapit nilai simpul atribut.
ReadState	Ketika ditimpa di kelas turunan, mendapatkan status pembaca.
SchemaInfo	Mendapatkan informasi skema yang telah ditetapkan ke simpul saat ini sebagai hasil validasi skema.
Settings	Mendapatkan objek yang XmlReaderSettings digunakan untuk membuat instans ini XmlReader .
Value	Saat ditimpa di kelas turunan, mendapatkan nilai teks simpul saat ini.
ValueType	Mendapatkan jenis Common Language Runtime (CLR) untuk simpul saat ini.
XmlLang	Ketika ditimpa di kelas turunan, mendapatkan cakupan saat ini xml:lang .
XmlSpace	Ketika ditimpa di kelas turunan, mendapatkan cakupan saat ini xml:space .

Metode

Nama	Deskripsi
Close()	Ketika ditimpa di kelas turunan, ubah menjadi ReadStateClosed.
Create(Stream, XmlReaderSettings, String)	Membuat instans baru XmlReader menggunakan aliran, URI dasar, dan pengaturan yang ditentukan.
Create(Stream, XmlReaderSettings, XmlParserContext)	Membuat instans baru XmlReader menggunakan streaming, pengaturan, dan informasi konteks yang ditentukan untuk penguraian.
Create(Stream, XmlReaderSettings)	Membuat instans baru XmlReader dengan streaming dan pengaturan yang ditentukan.
Create(Stream)	Membuat instans baru XmlReader menggunakan aliran yang ditentukan dengan pengaturan default.
Create(String, XmlReaderSettings, XmlParserContext)	Membuat instans baru XmlReader dengan menggunakan URI, pengaturan, dan informasi konteks yang ditentukan untuk penguraian.
Create(String, XmlReaderSettings)	Membuat instans baru XmlReader dengan menggunakan URI dan pengaturan yang ditentukan.
Create(String)	Membuat instans baru XmlReader dengan URI tertentu.
Create(TextReader, XmlReaderSettings, String)	Membuat instans baru XmlReader dengan menggunakan pembaca teks, pengaturan, dan URI dasar yang ditentukan.
Create(TextReader, XmlReaderSettings, XmlParserContext)	Membuat instans baru XmlReader dengan menggunakan pembaca teks, pengaturan, dan informasi konteks yang ditentukan untuk penguraian.
Create(TextReader, XmlReaderSettings)	Membuat instans baru XmlReader dengan menggunakan pembaca teks dan pengaturan yang ditentukan.
Create(TextReader)	Membuat instans baru XmlReader dengan menggunakan pembaca teks yang ditentukan.
Create(XmlReader, XmlReaderSettings)	Membuat instans baru XmlReader dengan menggunakan pembaca dan pengaturan XML yang ditentukan.
Dispose()	Merilis semua sumber daya yang digunakan oleh instans XmlReader kelas saat ini.
Dispose(Boolean)	Merilis sumber daya yang tidak dikelola yang XmlReader digunakan oleh dan secara opsional merilis sumber daya terkelola.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetAttribute(Int32)	Saat ditimpa dalam kelas turunan, mendapatkan nilai atribut dengan indeks yang ditentukan.
GetAttribute(String, String)	Ketika ditimpa dalam kelas turunan, mendapatkan nilai atribut dengan yang ditentukan LocalName dan NamespaceURI.
GetAttribute(String)	Ketika ditimpa dalam kelas turunan, mendapatkan nilai atribut dengan yang ditentukan Name.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
GetValueAsync()	Secara asinkron mendapatkan nilai simpul saat ini.
IsName(String)	Mengembalikan nilai yang menunjukkan apakah argumen string adalah nama XML yang valid.
IsNameToken(String)	Mengembalikan nilai yang menunjukkan apakah argumen string adalah token nama XML yang valid atau tidak.
IsStartElement()	MoveToContent() Panggilan dan pengujian jika simpul konten saat ini adalah tag awal atau tag elemen kosong.
IsStartElement(String, String)	MoveToContent() Panggilan dan pengujian jika node konten saat ini adalah tag awal atau tag elemen kosong dan jika LocalName properti dan NamespaceURI elemen yang ditemukan cocok dengan string yang diberikan.
IsStartElement(String)	MoveToContent() Panggilan dan pengujian jika simpul konten saat ini adalah tag awal atau tag elemen kosong dan jika Name properti elemen yang ditemukan cocok dengan argumen yang diberikan.
LookupNamespace(String)	Saat ditimpa dalam kelas turunan, menyelesaikan awalan namespace dalam cakupan elemen saat ini.
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
MoveToAttribute(Int32)	Saat ditimpa di kelas turunan, berpindah ke atribut dengan indeks yang ditentukan.
MoveToAttribute(String, String)	Saat ditimpa di kelas turunan, berpindah ke atribut dengan yang ditentukan LocalName dan NamespaceURI.
MoveToAttribute(String)	Ketika ditimpa di kelas turunan, berpindah ke atribut dengan yang ditentukan Name.
MoveToContent()	Memeriksa apakah simpul saat ini adalah konten (teks spasi non-putih, , CDATA, Element, EndElementEntityReferenceatau EndEntity) node. Jika simpul bukan node konten, pembaca melompat ke depan ke node konten berikutnya atau akhir file. Ini melewati simpul dari jenis berikut: ProcessingInstruction, , DocumentType, Comment, Whitespaceatau SignificantWhitespace.
MoveToContentAsync()	Secara asinkron memeriksa apakah simpul saat ini adalah node konten. Jika simpul bukan node konten, pembaca melompat ke depan ke node konten berikutnya atau akhir file.
MoveToElement()	Saat ditimpa di kelas turunan, berpindah ke elemen yang berisi node atribut saat ini.
MoveToFirstAttribute()	Saat ditimpa di kelas turunan, berpindah ke atribut pertama.
MoveToNextAttribute()	Saat ditimpa di kelas turunan, berpindah ke atribut berikutnya.
Read()	Saat ditimpa di kelas turunan, membaca simpul berikutnya dari aliran.
ReadAsync()	Secara asinkron membaca simpul berikutnya dari aliran.
ReadAttributeValue()	Saat ditimpa dalam kelas turunan, mengurai nilai atribut menjadi satu atau beberapa Textsimpul , EntityReference, atau EndEntity .
ReadContentAs(Type, IXmlNamespaceResolver)	Membaca konten sebagai objek dari tipe yang ditentukan.
ReadContentAsAsync(Type, IXmlNamespaceResolver)	Secara asinkron membaca konten sebagai objek dari jenis yang ditentukan.
ReadContentAsBase64(Byte[], Int32, Int32)	Membaca konten dan mengembalikan byte biner base64 yang didekodekan.
ReadContentAsBase64Async(Byte[], Int32, Int32)	Secara asinkron membaca konten dan mengembalikan byte biner base64 yang didekodekan.
ReadContentAsBinHex(Byte[], Int32, Int32)	Membaca konten dan mengembalikan BinHex byte biner yang didekodekan.
ReadContentAsBinHexAsync(Byte[], Int32, Int32)	Membaca konten secara asinkron dan mengembalikan BinHex byte biner yang didekodekan.
ReadContentAsBoolean()	Membaca konten teks pada posisi saat ini sebagai Boolean.
ReadContentAsDateTime()	Membaca isi teks pada posisi saat ini sebagai DateTime objek.
ReadContentAsDateTimeOffset()	Membaca isi teks pada posisi saat ini sebagai DateTimeOffset objek.
ReadContentAsDecimal()	Membaca isi teks pada posisi saat ini sebagai Decimal objek.
ReadContentAsDouble()	Membaca konten teks pada posisi saat ini sebagai angka floating-point presisi ganda.
ReadContentAsFloat()	Membaca konten teks pada posisi saat ini sebagai angka titik mengambang presisi tunggal.
ReadContentAsInt()	Membaca konten teks pada posisi saat ini sebagai bilangan bulat bertanda tangan 32-bit.
ReadContentAsLong()	Membaca konten teks pada posisi saat ini sebagai bilangan bulat bertanda tangan 64-bit.
ReadContentAsObject()	Membaca konten teks pada posisi saat ini sebagai Object.
ReadContentAsObjectAsync()	Secara asinkron membaca konten teks pada posisi saat ini sebagai Object.
ReadContentAsString()	Membaca isi teks pada posisi saat ini sebagai String objek.
ReadContentAsStringAsync()	Secara asinkron membaca konten teks pada posisi saat ini sebagai String objek.
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)	Memeriksa apakah nama lokal dan URI namespace yang ditentukan cocok dengan elemen saat ini, lalu membaca konten elemen sebagai jenis yang diminta.
ReadElementContentAs(Type, IXmlNamespaceResolver)	Membaca konten elemen sebagai jenis yang diminta.
ReadElementContentAsAsync(Type, IXmlNamespaceResolver)	Secara asinkron membaca konten elemen sebagai jenis yang diminta.
ReadElementContentAsBase64(Byte[], Int32, Int32)	Membaca elemen dan mendekode Base64 konten.
ReadElementContentAsBase64Async(Byte[], Int32, Int32)	Secara asinkron membaca elemen dan mendekode Base64 konten.
ReadElementContentAsBinHex(Byte[], Int32, Int32)	Membaca elemen dan mendekode BinHex konten.
ReadElementContentAsBinHexAsync(Byte[], Int32, Int32)	Secara asinkron membaca elemen dan mendekode BinHex konten.
ReadElementContentAsBoolean()	Membaca elemen saat ini dan mengembalikan konten sebagai Boolean objek.
ReadElementContentAsBoolean(String, String)	Memeriksa apakah nama lokal dan URI namespace yang ditentukan cocok dengan elemen saat ini, lalu membaca elemen saat ini dan mengembalikan konten sebagai Boolean objek.
ReadElementContentAsDateTime()	Membaca elemen saat ini dan mengembalikan konten sebagai DateTime objek.
ReadElementContentAsDateTime(String, String)	Memeriksa apakah nama lokal dan URI namespace yang ditentukan cocok dengan elemen saat ini, lalu membaca elemen saat ini dan mengembalikan konten sebagai DateTime objek.
ReadElementContentAsDecimal()	Membaca elemen saat ini dan mengembalikan konten sebagai Decimal objek.
ReadElementContentAsDecimal(String, String)	Memeriksa apakah nama lokal dan URI namespace yang ditentukan cocok dengan elemen saat ini, lalu membaca elemen saat ini dan mengembalikan konten sebagai Decimal objek.
ReadElementContentAsDouble()	Membaca elemen saat ini dan mengembalikan konten sebagai angka floating-point presisi ganda.
ReadElementContentAsDouble(String, String)	Memeriksa apakah nama lokal dan URI namespace yang ditentukan cocok dengan elemen saat ini, lalu membaca elemen saat ini dan mengembalikan konten sebagai angka floating-point presisi ganda.
ReadElementContentAsFloat()	Membaca elemen saat ini dan mengembalikan konten sebagai angka floating-point presisi tunggal.
ReadElementContentAsFloat(String, String)	Memeriksa apakah nama lokal dan URI namespace yang ditentukan cocok dengan elemen saat ini, lalu membaca elemen saat ini dan mengembalikan konten sebagai angka floating-point presisi tunggal.
ReadElementContentAsInt()	Membaca elemen saat ini dan mengembalikan konten sebagai bilangan bulat bertanda tangan 32-bit.
ReadElementContentAsInt(String, String)	Memeriksa apakah nama lokal dan URI namespace yang ditentukan cocok dengan elemen saat ini, lalu membaca elemen saat ini dan mengembalikan konten sebagai bilangan bulat bertanda tangan 32-bit.
ReadElementContentAsLong()	Membaca elemen saat ini dan mengembalikan konten sebagai bilangan bulat bertanda tangan 64-bit.
ReadElementContentAsLong(String, String)	Memeriksa apakah nama lokal dan URI namespace yang ditentukan cocok dengan elemen saat ini, lalu membaca elemen saat ini dan mengembalikan konten sebagai bilangan bulat bertanda tangan 64-bit.
ReadElementContentAsObject()	Membaca elemen saat ini dan mengembalikan konten sebagai Object.
ReadElementContentAsObject(String, String)	Memeriksa apakah nama lokal dan URI namespace yang ditentukan cocok dengan elemen saat ini, lalu membaca elemen saat ini dan mengembalikan konten sebagai Object.
ReadElementContentAsObjectAsync()	Secara asinkron membaca elemen saat ini dan mengembalikan konten sebagai Object.
ReadElementContentAsString()	Membaca elemen saat ini dan mengembalikan konten sebagai String objek.
ReadElementContentAsString(String, String)	Memeriksa apakah nama lokal dan URI namespace yang ditentukan cocok dengan elemen saat ini, lalu membaca elemen saat ini dan mengembalikan konten sebagai String objek.
ReadElementContentAsStringAsync()	Secara asinkron membaca elemen saat ini dan mengembalikan konten sebagai String objek.
ReadElementString()	Membaca elemen teks saja. Namun, kami sarankan Anda menggunakan metode sebagai ReadElementContentAsString() gantinya, karena menyediakan cara yang lebih mudah untuk menangani operasi ini.
ReadElementString(String, String)	Memeriksa apakah LocalName properti dan NamespaceURI elemen yang ditemukan cocok dengan string yang diberikan sebelum membaca elemen teks saja. Namun, kami sarankan Anda menggunakan metode sebagai ReadElementContentAsString(String, String) gantinya, karena menyediakan cara yang lebih mudah untuk menangani operasi ini.
ReadElementString(String)	Memeriksa apakah Name properti elemen yang ditemukan cocok dengan string yang diberikan sebelum membaca elemen teks saja. Namun, kami sarankan Anda menggunakan metode sebagai ReadElementContentAsString() gantinya, karena menyediakan cara yang lebih mudah untuk menangani operasi ini.
ReadEndElement()	Memeriksa apakah simpul konten saat ini adalah tag akhir dan memajukan pembaca ke simpul berikutnya.
ReadInnerXml()	Saat ditimpa di kelas turunan, membaca semua konten, termasuk markup, sebagai string.
ReadInnerXmlAsync()	Secara asinkron membaca semua konten, termasuk markup, sebagai string.
ReadOuterXml()	Ketika ditimpa di kelas turunan, membaca konten, termasuk markup, mewakili simpul ini dan semua anak-anaknya.
ReadOuterXmlAsync()	Secara asinkron membaca konten, termasuk markup, mewakili simpul ini dan semua anaknya.
ReadStartElement()	Memeriksa apakah simpul saat ini adalah elemen dan memajukan pembaca ke simpul berikutnya.
ReadStartElement(String, String)	Memeriksa apakah simpul konten saat ini adalah elemen dengan yang diberikan LocalName dan NamespaceURI dan memajukan pembaca ke simpul berikutnya.
ReadStartElement(String)	Memeriksa apakah simpul konten saat ini adalah elemen dengan yang diberikan Name dan memajukan pembaca ke simpul berikutnya.
ReadString()	Saat ditimpa dalam kelas turunan, membaca konten elemen atau node teks sebagai string. Namun, kami sarankan Anda menggunakan metode sebagai ReadElementContentAsString gantinya, karena menyediakan cara yang lebih mudah untuk menangani operasi ini.
ReadSubtree()	Mengembalikan instans baru XmlReader yang dapat digunakan untuk membaca simpul saat ini, dan semua turunannya.
ReadToDescendant(String, String)	Memajukan XmlReader ke elemen turunan berikutnya dengan nama lokal dan URI namespace yang ditentukan.
ReadToDescendant(String)	Memajukan XmlReader ke elemen turunan berikutnya dengan nama yang memenuhi syarat yang ditentukan.
ReadToFollowing(String, String)	Membaca hingga elemen dengan nama lokal dan URI namespace yang ditentukan ditemukan.
ReadToFollowing(String)	Membaca hingga elemen dengan nama yang memenuhi syarat yang ditentukan ditemukan.
ReadToNextSibling(String, String)	Memajukan XmlReader ke elemen saudara berikutnya dengan nama lokal dan URI namespace yang ditentukan.
ReadToNextSibling(String)	Memajukan XmlReader ke elemen saudara kandung berikutnya dengan nama yang memenuhi syarat yang ditentukan.
ReadValueChunk(Char[], Int32, Int32)	Membaca aliran besar teks yang disematkan dalam dokumen XML.
ReadValueChunkAsync(Char[], Int32, Int32)	Secara asinkron membaca aliran besar teks yang disematkan dalam dokumen XML.
ResolveEntity()	Saat ditimpa di kelas turunan, menyelesaikan referensi entitas untuk EntityReference simpul.
Skip()	Melompati anak-anak dari simpul saat ini.
SkipAsync()	Secara asinkron melompati anak-anak simpul saat ini.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• Dokumen dan Data XML