XmlTextReader.EntityHandling Tulajdonság
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Lekéri vagy beállít egy értéket, amely meghatározza, hogy az olvasó hogyan kezeli az entitásokat.
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
Tulajdonság értéke
Az egyik EntityHandling érték. Ha nincs EntityHandling megadva, az alapértelmezés szerint a .EntityHandling.ExpandCharEntities
Megjegyzések
Note
Javasoljuk, hogy az új funkciók kihasználásához hozzon létre XmlReader példányokat a XmlReader.Create metódus használatával.
Ez a tulajdonság menet közben módosítható, és a következő Read hívás után lép érvénybe.
Ha EntityHandling be van állítva ExpandCharEntities, az attribútumértékek csak részben normalizálódnak. Az olvasó az egyes szöveges csomópontokat a szomszédos entitáshivatkozási csomópontok tartalmától függetlenül normalizálja.
Az entitáskezelési módok közötti különbség szemléltetéséhez tekintse meg a következő XML-t:
<!DOCTYPE doc [<!ENTITY num "123">]>
<doc> A # </doc>
Ha EntityHandling a "doc" elemcsomópontra ExpandEntities van állítva, egy szöveges csomópontot tartalmaz a kibontott entitásszöveggel:
| Mélység | Csomópont típusa | Name | Érték |
|---|---|---|---|
| 1 | Text |
A 123 |
Ha EntityHandling a "doc" elem a következőre ExpandCharEntitiesvan állítva, és WhitespaceHandling az értékre van állítva Significant , Allakkor a "doc" elem kibontja a karakterentitást, és csomópontként adja vissza az általános entitást:
| Mélység | Csomópont típusa | Name | Érték |
|---|---|---|---|
| 1 | Text |
A | |
| 1 | EntityReference |
Num | |
| 1 | SignificantWhitespace |