XmlValidatingReader.EntityHandling Vlastnost

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Zdroj:

XmlValidatingReader.cs

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 je EntityHandling.ExpandEntities.

Výjimky

ArgumentOutOfRangeException

Byla zadána neplatná hodnota.

Poznámky

Poznámka:

Třída XmlValidatingReader je zastaralá v rozhraní .NET Framework 2.0. Ověření instance můžete vytvořit XmlReader pomocí XmlReaderSettings třídy a Create metody. Další informace najdete v části Poznámky na XmlReader referenční stránce.

Tuto vlastnost lze změnit 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ů odkazu na entitu.

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	NodeType	název	Hodnota
1	Text		A 123

Pokud EntityHandling je nastavena na ExpandCharEntitieshodnotu WhitespaceHandling a je nastavena na hodnotu Význam nebo Vše, element "doc" rozbalí entitu znaku a vrátí obecnou entitu jako uzel:

Hloubka	NodeType	název	Hodnota
1	Text		A
1	EntityReference	číslo
1	SignificantWhitespace

Viz také

• XmlReader