Bagikan melalui


XmlReader Kelas

Definisi

Mewakili pembaca yang menyediakan akses cepat, tidak di-cache, dan hanya maju ke data XML.

public ref class XmlReader abstract : IDisposable
public ref class XmlReader abstract
public abstract class XmlReader : IDisposable
public abstract class XmlReader
type XmlReader = class
    interface IDisposable
type XmlReader = class
Public MustInherit Class XmlReader
Implements IDisposable
Public MustInherit Class XmlReader
Warisan
XmlReader
Turunan
Penerapan

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

XmlReader()

Menginisialisasi instans baru kelas XmlReader.

Properti

AttributeCount

Ketika ditimpa di kelas turunan, mendapatkan jumlah atribut pada simpul saat ini.

BaseURI

Ketika ditimpa di kelas turunan, mendapatkan URI dasar dari 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

Ketika 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 di kelas turunan, mendapatkan nilai yang menunjukkan apakah simpul saat ini dapat memiliki Value.

IsDefault

Ketika ditimpa di 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 di kelas turunan, mendapatkan nilai yang menunjukkan apakah simpul saat ini adalah elemen kosong (misalnya, <MyElement/>).

Item[Int32]

Saat ditimpa di kelas turunan, mendapatkan nilai atribut dengan indeks yang ditentukan.

Item[String, String]

Ketika ditimpa di kelas turunan, mendapatkan nilai atribut dengan yang ditentukan LocalName dan NamespaceURI.

Item[String]

Ketika ditimpa di 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 simpul saat ini.

NamespaceURI

Ketika ditimpa di kelas turunan, mendapatkan URI namespace layanan (seperti yang didefinisikan dalam spesifikasi Namespace W3C) dari simpul tempat pembaca berada.

NameTable

Ketika ditimpa di kelas turunan XmlNameTable , akan dikaitkan 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 di 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 dari 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

Close()

Ketika ditimpa di kelas turunan, mengubah menjadi ReadStateClosed.

Create(Stream)

Membuat instans baru XmlReader menggunakan aliran yang ditentukan dengan pengaturan default.

Create(Stream, XmlReaderSettings)

Membuat instans baru XmlReader dengan aliran dan pengaturan yang ditentukan.

Create(Stream, XmlReaderSettings, String)

Membuat instans baru XmlReader menggunakan aliran, URI dasar, dan pengaturan yang ditentukan.

Create(Stream, XmlReaderSettings, XmlParserContext)

Membuat instans XmlReader baru menggunakan streaming, pengaturan, dan informasi konteks yang ditentukan untuk penguraian.

Create(String)

Membuat instans baru XmlReader dengan URI tertentu.

Create(String, XmlReaderSettings)

Membuat instans baru XmlReader dengan menggunakan URI dan pengaturan yang ditentukan.

Create(String, XmlReaderSettings, XmlParserContext)

Membuat instans baru XmlReader dengan menggunakan URI, pengaturan, dan informasi konteks yang ditentukan untuk penguraian.

Create(TextReader)

Membuat instans baru XmlReader dengan menggunakan pembaca teks yang ditentukan.

Create(TextReader, XmlReaderSettings)

Membuat instans baru XmlReader dengan menggunakan pembaca dan pengaturan teks yang ditentukan.

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(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 tidak terkelola yang digunakan oleh XmlReader 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 di kelas turunan, mendapatkan nilai atribut dengan indeks yang ditentukan.

GetAttribute(String)

Ketika ditimpa di kelas turunan, mendapatkan nilai atribut dengan yang ditentukan Name.

GetAttribute(String, String)

Ketika ditimpa di kelas turunan, mendapatkan nilai atribut dengan yang ditentukan LocalName dan NamespaceURI.

GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetType()

Mendapatkan dari instans Type 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 mulai atau tag elemen kosong.

IsStartElement(String)

MoveToContent() Panggilan dan pengujian jika simpul konten saat ini adalah tag mulai atau tag elemen kosong dan jika Name properti elemen yang ditemukan cocok dengan argumen yang diberikan.

IsStartElement(String, String)

MoveToContent() Panggilan dan pengujian jika simpul konten saat ini adalah tag mulai atau tag elemen kosong dan jika LocalName properti dan NamespaceURI elemen yang ditemukan cocok dengan string yang diberikan.

LookupNamespace(String)

Saat ditimpa di kelas turunan, menyelesaikan awalan namespace dalam cakupan elemen saat ini.

MemberwiseClone()

Membuat salinan dangkal dari saat ini Object.

(Diperoleh dari Object)
MoveToAttribute(Int32)

Saat ditimpa di kelas turunan, berpindah ke atribut dengan indeks yang ditentukan.

MoveToAttribute(String)

Saat ditimpa di kelas turunan, berpindah ke atribut dengan yang ditentukan Name.

MoveToAttribute(String, String)

Saat ditimpa di kelas turunan, berpindah ke atribut dengan yang ditentukan LocalName dan NamespaceURI.

MoveToContent()

Memeriksa apakah simpul saat ini adalah konten (teks spasi non-putih, CDATA, Element, EndElement, EntityReferenceatau EndEntity) simpul. Jika node bukan node konten, pembaca melompat ke node konten berikutnya atau akhir file. Ini melompati simpul dari jenis berikut: ProcessingInstruction, , DocumentTypeComment, Whitespace, atau SignificantWhitespace.

MoveToContentAsync()

Secara asinkron memeriksa apakah simpul saat ini adalah simpul konten. Jika node bukan node konten, pembaca melompat 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 di kelas turunan, uraikan nilai atribut menjadi satu atau beberapa Textsimpul , EntityReference, atau EndEntity .

ReadContentAs(Type, IXmlNamespaceResolver)

Membaca konten sebagai objek dari jenis 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 yang didekodekan Base64.

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)

Membaca konten elemen sebagai jenis yang diminta.

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.

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 namespace URI yang ditentukan cocok dengan elemen saat ini, lalu membaca elemen saat ini dan mengembalikan konten sebagai angka titik floating presisi ganda.

ReadElementContentAsFloat()

Membaca elemen saat ini dan mengembalikan konten sebagai angka floating-point presisi tunggal.

ReadElementContentAsFloat(String, String)

Memeriksa apakah nama lokal dan namespace layanan URI 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 namespace URI 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 namespace URI 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 namespace URI 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 ini ReadElementContentAsString() sebagai 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 ini ReadElementContentAsString() sebagai 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 ini ReadElementContentAsString(String, String) sebagai 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 turunannya.

ReadOuterXmlAsync()

Secara asinkron membaca konten, termasuk markup, mewakili simpul ini dan semua turunannya.

ReadStartElement()

Memeriksa apakah simpul saat ini adalah elemen dan memajukan pembaca ke simpul berikutnya.

ReadStartElement(String)

Memeriksa bahwa simpul konten saat ini adalah elemen dengan yang diberikan Name dan memajukan pembaca ke simpul berikutnya.

ReadStartElement(String, String)

Memeriksa bahwa simpul konten saat ini adalah elemen dengan yang diberikan LocalName dan NamespaceURI dan memajukan pembaca ke simpul berikutnya.

ReadString()

Saat ditimpa di kelas turunan, membaca konten elemen atau simpul teks sebagai string. Namun, kami sarankan Anda menggunakan metode ini ReadElementContentAsString sebagai 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)

Memajukan XmlReader ke elemen turunan berikutnya dengan nama yang memenuhi syarat yang ditentukan.

ReadToDescendant(String, String)

Memajukan XmlReader ke elemen turunan berikutnya dengan nama lokal dan URI namespace yang ditentukan.

ReadToFollowing(String)

Membaca hingga elemen dengan nama yang memenuhi syarat yang ditentukan ditemukan.

ReadToFollowing(String, String)

Membaca hingga elemen dengan nama lokal dan URI namespace yang ditentukan ditemukan.

ReadToNextSibling(String)

Memajukan XmlReader ke elemen saudara kandung berikutnya dengan nama yang memenuhi syarat yang ditentukan.

ReadToNextSibling(String, String)

Memajukan XmlReader ke elemen saudara kandung berikutnya dengan nama lokal dan URI namespace 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 dari simpul saat ini.

ToString()

Mengembalikan string yang mewakili objek saat ini.

(Diperoleh dari Object)

Implementasi Antarmuka Eksplisit

IDisposable.Dispose()

Untuk deskripsi anggota ini, lihat Dispose().

Berlaku untuk

Lihat juga