XmlValidatingReader.EntityHandling Properti

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlValidatingReader.cs

Mendapatkan atau menetapkan nilai yang menentukan cara pembaca menangani entitas.

public:
 property System::Xml::EntityHandling EntityHandling { System::Xml::EntityHandling get(); void set(System::Xml::EntityHandling value); };

public System.Xml.EntityHandling EntityHandling { get; set; }

member this.EntityHandling : System.Xml.EntityHandling with get, set

Public Property EntityHandling As EntityHandling

Nilai Properti

EntityHandling

Salah EntityHandling satu nilai. Jika tidak EntityHandling ditentukan, defaultnya ke EntityHandling.ExpandEntities.

Pengecualian

ArgumentOutOfRangeException

Nilai tidak valid ditentukan.

Keterangan

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.

Properti ini dapat diubah dan berlaku setelah panggilan berikutnya Read .

Ketika EntityHandling diatur ke ExpandCharEntities, nilai atribut hanya dinormalisasi sebagian. Pembaca menormalkan setiap simpul teks individual secara independen dari konten simpul referensi entitas yang berdekatan.

Untuk mengilustrasikan perbedaan antara mode penanganan entitas, pertimbangkan XML berikut:

<!DOCTYPE doc [<!ENTITY num "123">]>
 <doc> &#65; &num; </doc>

Ketika EntityHandling diatur ke ExpandEntities node elemen "doc" berisi satu simpul teks dengan teks entitas yang diperluas:

Kedalaman	NodeType	Nama	Nilai
1	Teks		A 123

Ketika EntityHandling diatur ke ExpandCharEntities, dan WhitespaceHandling diatur ke Signifikan atau Semua, elemen "doc" memperluas entitas karakter dan mengembalikan entitas umum sebagai simpul:

Kedalaman	NodeType	Nama	Nilai
1	Teks		A
1	EntityReference	Num
1	SignificantWhitespace

Lihat juga

• XmlReader