XmlReaderSettings.CheckCharacters Properti

Definisi

Ruang nama:
System.Xml
Rakitan:
System.Xml.dll, System.Xml.ReaderWriter.dll
Rakitan:
netstandard.dll, System.Xml.ReaderWriter.dll
Rakitan:
System.Xml.ReaderWriter.dll
Rakitan:
System.Xml.dll
Rakitan:
netstandard.dll
Sumber:
XmlReaderSettings.cs
Sumber:
XmlReaderSettings.cs
Sumber:
XmlReaderSettings.cs
Sumber:
XmlReaderSettings.cs
Sumber:
XmlReaderSettings.cs

Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan melakukan pemeriksaan karakter.

public:
 property bool CheckCharacters { bool get(); void set(bool value); };
public bool CheckCharacters { get; set; }
member this.CheckCharacters : bool with get, set
Public Property CheckCharacters As Boolean

Nilai Properti

Boolean

true untuk melakukan pemeriksaan karakter; jika tidak false. Defaultnya adalah true.

Keterangan

Properti ini menginstruksikan pembaca XML untuk memeriksa karakter dalam data XML yang XmlException dibacanya dan melempar jika ada karakter di luar rentang karakter XML legal. Saat pemeriksaan karakter diaktifkan, Anda dipastikan sebagai berikut:

  • Karakter berada dalam rentang karakter XML legal, seperti yang didefinisikan oleh bagian 2,2 Karakter dari Rekomendasi XML 1.0 W3C.

  • Semua nama XML valid, seperti yang didefinisikan oleh bagian Konstruksi Syntactic Umum 2.3 dari Rekomendasi XML W3C 1.0.

Ketika properti ini diatur ke true, yang merupakan pengaturan default, XmlException pengecualian dilemparkan jika file XML berisi karakter ilegal atau nama XML yang tidak valid (misalnya, nama elemen dimulai dengan angka).

XmlReader Jika sedang memproses data teks, selalu memeriksa bahwa nama XML dan konten teks valid, terlepas dari pengaturan properti. Mengatur CheckCharacters ke false menonaktifkan pemeriksaan karakter untuk referensi entitas karakter.

Berlaku untuk