XmlTextReader.EntityHandling Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar eller anger ett värde som anger hur läsaren hanterar entiteter.
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, setPublic Property EntityHandling As EntityHandlingEgenskapsvärde
Ett av EntityHandling värdena. Om inget EntityHandling har angetts är standardvärdet EntityHandling.ExpandCharEntities.
Kommentarer
Note
Vi rekommenderar att du skapar XmlReader instanser genom att använda XmlReader.Create metoden för att dra nytta av nya funktioner.
Den här egenskapen kan ändras i farten och börjar gälla efter nästa Read anrop.
När EntityHandling är inställt på ExpandCharEntitiesnormaliseras attributvärden endast delvis. Läsaren normaliserar varje enskild textnod oberoende av innehållet i angränsande entitetsreferensnoder.
För att illustrera skillnaden mellan entitetshanteringslägena bör du överväga följande XML:
<!DOCTYPE doc [<!ENTITY num "123">]>
<doc> A # </doc>
När EntityHandling är inställt på ExpandEntities "doc"-elementnoden innehåller en textnod med den expanderade entitetstexten:
| Djup | Nodtyp | Name | Value |
|---|---|---|---|
| 1 | Text |
A 123 |
När EntityHandling är inställt på ExpandCharEntities, och WhitespaceHandling är inställt på Significant eller All, expanderar "doc"-elementet teckenentiteten och returnerar den allmänna entiteten som en nod:
| Djup | Nodtyp | Name | Value |
|---|---|---|---|
| 1 | Text |
A | |
| 1 | EntityReference |
Num | |
| 1 | SignificantWhitespace |
