XmlValidatingReader.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 det som standard EntityHandling.ExpandEntiteter.
Undantag
Ogiltigt värde har angetts.
Kommentarer
Note
Klassen XmlValidatingReader är föråldrad i .NET Framework 2.0. Du kan skapa en verifierande XmlReader instans med hjälp XmlReaderSettings av -klassen och Create -metoden. Mer information finns i avsnittet Kommentarer på XmlReader referenssidan.
Den här egenskapen kan ändras 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 | NodeType | Name | Value |
|---|---|---|---|
| 1 | Text | A 123 |
När EntityHandling är inställt på ExpandCharEntities, och WhitespaceHandling är inställt på Betydande eller Alla, expanderar "doc"-elementet teckenentiteten och returnerar den allmänna entiteten som en nod:
| Djup | NodeType | Name | Value |
|---|---|---|---|
| 1 | Text | A | |
| 1 | EntityReference | Num | |
| 1 | SignificantWhitespace |
