XmlTextReader.EntityHandling Vlastnost

Definice

Obor názvů:

System.Xml

Sestavení:

System.Xml.ReaderWriter.dll

Sestavení:

System.Xml.dll

Sestavení:

netstandard.dll

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, set

Public Property EntityHandling As EntityHandling

Hodnota vlastnosti

EntityHandling

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

Viz také

• XmlReader