XmlTextReader.EntityHandling Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
Salah EntityHandling satu nilai. Jika tidak EntityHandling ditentukan, defaultnya ke EntityHandling.ExpandCharEntities.
Keterangan
Nota
Kami menyarankan Anda membuat instans XmlReader untuk memanfaatkan fungsionalitas baru dengan menggunakan metode XmlReader.Create.
Properti ini dapat diubah dengan cepat 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> A # </doc>
Ketika EntityHandling diatur ke ExpandEntities node elemen "doc" berisi satu simpul teks dengan teks entitas yang diperluas:
| Kedalaman | Jenis node | Nama | Nilai |
|---|---|---|---|
| 1 | Text |
A 123 |
Ketika EntityHandling diatur ke ExpandCharEntities, dan WhitespaceHandling diatur ke Significant atau All, elemen "doc" memperluas entitas karakter dan mengembalikan entitas umum sebagai simpul:
| Kedalaman | Jenis node | Nama | Nilai |
|---|---|---|---|
| 1 | Text |
A | |
| 1 | EntityReference |
Num | |
| 1 | SignificantWhitespace |