XmlValidatingReader.ReadString Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlValidatingReader.cs

Membaca konten elemen atau simpul teks sebagai string.

public:
 override System::String ^ ReadString();

public override string ReadString();

override this.ReadString : unit -> string

Public Overrides Function ReadString () As String

Mengembalikan

String

Konten elemen atau node teks. Ini bisa menjadi string kosong jika pembaca diposisikan pada sesuatu selain elemen atau node teks, atau jika tidak ada lagi konten teks untuk dikembalikan dalam konteks saat ini.

Keterangan

Simpul teks dapat berupa elemen atau node teks atribut.

Nota

Kelas XmlValidatingReader usang dalam .NET Framework 2.0. Anda dapat membuat instans validasi XmlReader dengan menggunakan XmlReaderSettings kelas dan Create metode . Untuk informasi selengkapnya, lihat bagian Keterangan dari halaman referensi XmlReader.

Jika diposisikan pada elemen, ReadString menggabungkan semua teks, spasi putih yang signifikan, spasi kosong, dan jenis node bagian CDATA bersama-sama dan mengembalikan data yang digabungkan sebagai konten elemen. Pembaca berhenti ketika markup ditemui, termasuk komentar dan instruksi pemrosesan. Ini dapat terjadi dalam model konten campuran, atau ketika tag akhir elemen dibaca.

Jika diposisikan pada simpul teks, ReadString lakukan perangkaian yang sama dari simpul teks ke tag akhir elemen. Jika pembaca diposisikan pada node teks atribut, ReadString memiliki fungsionalitas yang sama seolah-olah pembaca berada di posisi pada tag mulai elemen. Ini mengembalikan semua simpul teks elemen yang digabungkan.

Properti EntityHandling menentukan cara ReadString kerjanya sebagai berikut:

Nilai	Deskripsi
ExpandEntities	Mengembalikan karakter yang diperluas dan entitas umum. Ini adalah default.
ExpandCharEntities	Mengembalikan konten teks hingga tetapi tidak menyertakan referensi entitas umum. Ini berarti entitas umum menyebabkan ReadString berhenti. Anda harus memanggil Read untuk melangkahi referensi entitas.

Lihat juga

• XmlReader