XmlReader.ReadContentAsObject Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlReader.cs

Membaca konten teks pada posisi saat ini sebagai Object.

public:
 virtual System::Object ^ ReadContentAsObject();

public virtual object ReadContentAsObject();

abstract member ReadContentAsObject : unit -> obj
override this.ReadContentAsObject : unit -> obj

Public Overridable Function ReadContentAsObject () As Object

Mengembalikan

Object

Konten teks sebagai objek runtime bahasa umum (CLR) yang paling tepat.

Pengecualian

InvalidCastException

Pemeran yang dicoba tidak valid.

FormatException

Format string tidak valid.

InvalidOperationException

Metode XmlReader dipanggil sebelum operasi asinkron sebelumnya selesai. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Operasi asinkron sudah berlangsung."

Keterangan

Metode ini menggabungkan teks, spasi kosong, ruang kosong yang signifikan, dan bagian CDATA, dan melewati komentar atau instruksi pemrosesan apa pun. Referensi entitas diselesaikan secara otomatis.

Jika konten ditik, pembaca mengembalikan CLR dalam kotak dari jenis yang paling sesuai, yang ditentukan oleh ValueType properti . Jika konten adalah jenis daftar, pembaca mengembalikan array objek kotak dari jenis yang sesuai.

Nota

Jika terjadi kesalahan validasi saat mengurai konten dan pembaca adalah objek yang XmlReader dibuat oleh Create metode , pembaca mengembalikan konten sebagai string. Dengan kata lain ketika terjadi kesalahan validasi atau peringatan, konten dianggap tidak ditiru.

Jika konten tidak ditik, pembaca mengembalikan konten sebagai string.

Tabel berikut menjelaskan bagaimana metode ini memperlakukan setiap jenis node.

XmlNodeType	Nilai kembalian	Perilaku pembaca
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity	Konten teks yang digabungkan, CDATA, spasi kosong, dan simpul spasi putih yang signifikan dikonversi ke jenis yang diminta.	Berpindah ke elemen mulai berikutnya atau tag elemen akhir. Referensi entitas secara otomatis diperluas.
Attribute	Sama seperti memanggil XmlConvert.ToXxx pada nilai atribut.	Pembaca tetap berada di posisi saat ini
Comment ProcessingInstruction	Mengabaikan instruksi pemrosesan (PI) atau komentar dan membaca konten teks yang digabungkan yang mengikuti PI atau komentar.	Berpindah ke elemen mulai berikutnya atau tag elemen akhir. Referensi entitas secara otomatis diperluas.
EndElement	Nilai elemen jika pembaca adalah pembaca validasi skema (ValidationType diatur ke Schema); jika tidak, string kosong.	Pembaca tetap berada di posisi saat ini.
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment	Sebuah InvalidOperationException dilemparkan.	Tidak terdefinisi, meskipun biasanya pembaca tetap berada di posisi saat ini.

Untuk informasi selengkapnya, lihat bagian Keterangan dari XmlReader halaman referensi dan rekomendasi Skema XML W3C Bagian 2: Jenis data .

Untuk versi asinkron dari metode ini, lihat ReadContentAsObjectAsync.