XmlValidatingReader.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, alapértelmezés szerint az EntityHandling.ExpandEntities lesz.
Kivételek
Érvénytelen érték lett megadva.
Megjegyzések
Note
A XmlValidatingReader osztály elavult .NET Framework 2.0-s verziója esetén. Az osztály és a XmlReader metódus használatával létrehozhat egy érvényesítő XmlReaderSettings példánytCreate. További információt a referenciaoldal Megjegyzések szakaszában XmlReader talál.
Ez a tulajdonság 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 | Szöveg | A 123 |
EntityHandlingA ExpandCharEntities "doc" elem kiterjeszti a karakterentitást, és WhitespaceHandling csomópontként adja vissza az általános entitást:
| Mélység | Csomópont típusa | Name | Érték |
|---|---|---|---|
| 1 | Szöveg | A | |
| 1 | EntityReference | Num | |
| 1 | JelentősHelyköz |