XmlValidatingReader.EntityHandling Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta un valore che specifica la modalità di gestione delle entità da parte del lettore.
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 EntityHandlingValore della proprietà
Uno dei EntityHandling valori. Se non viene specificato alcun EntityHandling valore, per impostazione predefinita è EntityHandling.ExpandEntities.
Eccezioni
È stato specificato un valore non valido.
Commenti
Annotazioni
La XmlValidatingReader classe è obsoleta in .NET Framework 2.0. È possibile creare un'istanza di convalida XmlReader usando la XmlReaderSettings classe e il Create metodo . Per altre informazioni, vedere la sezione Note della pagina di riferimento XmlReader.
Questa proprietà può essere modificata 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> A # </doc>
Quando EntityHandling è impostato ExpandEntities sul nodo dell'elemento "doc" contiene un nodo di testo con il testo dell'entità espanso:
| Profondità | NodeType | Nome | Valore |
|---|---|---|---|
| 1 | Text | A 123 |
Quando EntityHandling è impostato su ExpandCharEntitiese WhitespaceHandling è impostato su Significativo o Tutto, l'elemento "doc" espande l'entità carattere e restituisce l'entità generale come nodo:
| Profondità | NodeType | Nome | Valore |
|---|---|---|---|
| 1 | Text | Un | |
| 1 | EntityReference | num | |
| 1 | SignificantWhitespace |
