XmlTextReader.EntityHandling Proprietà

Definizione

Spazio dei nomi:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Origine:

XmlTextReader.cs

Ottiene o imposta un valore che specifica il modo in cui il lettore gestisce le entità.

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

Valore della proprietà

EntityHandling

Uno dei valori di EntityHandling. Se non viene specificato nessun oggetto EntityHandling, per impostazione predefinita viene usato EntityHandling.ExpandCharEntities.

Commenti

Nota

A partire da .NET Framework 2.0, è consigliabile creare XmlReader istanze usando il XmlReader.Create metodo per sfruttare le nuove funzionalità.

Questa proprietà può essere modificata in tempo reale e diventa effettiva dopo la chiamata successiva Read .

Quando EntityHandling è impostato su ExpandCharEntities, i valori degli attributi vengono normalizzati solo parzialmente. Il lettore normalizza ogni singolo nodo di testo indipendentemente dal contenuto dei nodi di riferimento di entità adiacenti.

Per illustrare la differenza tra le modalità di gestione delle entità, considerare il codice XML seguente:

<!DOCTYPE doc [<!ENTITY num "123">]>
    <doc> &#65; &num; </doc>

Quando EntityHandling è impostato ExpandEntities sul nodo dell'elemento "doc" contiene un nodo di testo con il testo dell'entità espansa:

Profondità	Tipo di nodo	Nome	Valore
1	Text		A 123

Quando EntityHandling è impostato su ExpandCharEntitiese WhitespaceHandling è impostato su Significant o All, l'elemento "doc" espande l'entità carattere e restituisce l'entità generale come nodo:

Profondità	Tipo di nodo	Nome	Valore
1	Text		A
1	EntityReference	num
1	SignificantWhitespace

Vedi anche

• XmlReader