XmlTextReader.EntityHandling Tulajdonság

Definíció

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> &#65; &num; </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

A következőre érvényes:

Lásd még