XmlReader.ReadContentAsString Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlReader.cs

Membaca isi teks pada posisi saat ini sebagai String objek.

public:
 virtual System::String ^ ReadContentAsString();

public virtual string ReadContentAsString();

abstract member ReadContentAsString : unit -> string
override this.ReadContentAsString : unit -> string

Public Overridable Function ReadContentAsString () As String

Mengembalikan

String

Konten teks sebagai String objek.

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.

Metode ini dapat digunakan untuk mengonversi nilai yang di ketik menjadi string, atau untuk membaca konten teks sambil melewati komentar dan instruksi pemrosesan.

Tabel berikut menjelaskan bagaimana metode ini memperlakukan setiap jenis node.

XmlNodeType	Mengembalikan nilai	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	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 ReadContentAsStringAsync.