XmlTextReader.EntityHandling Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví hodnotu, která určuje, jak čtenář zpracovává entity.
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 EntityHandlingHodnota vlastnosti
Jedna z EntityHandling hodnot. Pokud není zadána žádná EntityHandling , výchozí hodnota EntityHandling.ExpandCharEntitiesje .
Poznámky
Poznámka
Počínaje rozhraním .NET Framework 2.0 doporučujeme vytvářet XmlReader instance pomocí XmlReader.Create metody, abyste mohli využívat nové funkce.
Tuto vlastnost lze změnit za běhu a projeví se po dalším Read volání.
Pokud EntityHandling je nastavena na ExpandCharEntitieshodnotu , hodnoty atributů jsou pouze částečně normalizovány. Čtenář normalizuje každý jednotlivý textový uzel nezávisle na obsahu sousedních uzlů odkazů na entity.
Pokud chcete znázornit rozdíl mezi režimy zpracování entit, zvažte následující xml:
<!DOCTYPE doc [<!ENTITY num "123">]>
<doc> A # </doc>
Pokud EntityHandling je nastavena na ExpandEntities uzel elementu "doc", obsahuje jeden textový uzel s rozbaleným textem entity:
| Hloubka | Typ uzlu | Name | Hodnota |
|---|---|---|---|
| 1 | Text |
A 123 |
Když EntityHandling je nastavena na ExpandCharEntitieshodnotu a WhitespaceHandling je nastavena na Significant nebo All, element "doc" rozbalí entitu znaku a vrátí obecnou entitu jako uzel:
| Hloubka | Typ uzlu | Name | Hodnota |
|---|---|---|---|
| 1 | Text |
A | |
| 1 | EntityReference |
num | |
| 1 | SignificantWhitespace |