XmlTextReader.EntityHandling Proprietà

Definizione

Ottiene o imposta un valore che specifica il modo in cui il lettore gestisce le entità.Gets or sets a value that specifies how the reader handles entities.

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à

Uno dei valori di EntityHandling.One of the EntityHandling values. Se non viene specificato nessun oggetto EntityHandling, per impostazione predefinita viene usato EntityHandling.ExpandCharEntities.If no EntityHandling is specified, it defaults to EntityHandling.ExpandCharEntities.

Commenti

Nota

A partire dalla .NET Framework 2,0, è consigliabile creare istanze di XmlReader usando il metodo XmlReader.Create per sfruttare le nuove funzionalità.Starting with the .NET Framework 2.0, we recommend that you create XmlReader instances by using the XmlReader.Create method to take advantage of new functionality.

Questa proprietà può essere modificata in tempo reale e diventa effettiva dopo la chiamata di Read successiva.This property can be changed on the fly and takes effect after the next Read call.

Quando EntityHandling è impostato su ExpandCharEntities, i valori di attributo sono solo parzialmente normalizzati.When EntityHandling is set to ExpandCharEntities, attribute values are only partially normalized. Il lettore normalizza ogni singolo nodo di testo indipendentemente dal contenuto dei nodi adiacenti di riferimento all'entità.The reader normalizes each individual text node independently from the content of adjacent entity reference nodes.

Per illustrare la differenza tra le modalità di gestione delle entità, si consideri il seguente codice XML:To illustrate the difference between the entity handling modes consider the following XML:

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

Quando EntityHandling è impostato su ExpandEntities il nodo dell'elemento "doc" contiene un nodo di testo con il testo dell'entità espansa:When EntityHandling is set to ExpandEntities the "doc" element node contains one text node with the expanded entity text:

ProfonditàDepth Tipo di nodoNode type NOMEName ValoreValue
11 Text A 123A 123

Quando EntityHandling è impostato su ExpandCharEntitiese WhitespaceHandling è impostato su Significant o All, l'elemento "doc" espande l'entità di caratteri e restituisce l'entità generale come nodo:When EntityHandling is set to ExpandCharEntities, and WhitespaceHandling is set to Significant or All, the "doc" element expands the character entity and returns the general entity as a node:

ProfonditàDepth Tipo di nodoNode type NOMEName ValoreValue
11 Text AA
11 EntityReference numnum
11 SignificantWhitespace

Si applica a

Vedi anche