Proprietà XmlTextReader.EntityHandling (System.Xml)

Cambia visualizzazione:
Classica
Lightweight
ScriptFree
Riferimento a .NET Framework
Proprietà XmlTextReader.EntityHandling

Nota: questa proprietà è stata introdotta con .NET Framework versione 2.0.

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

Spazio dei nomi: System.Xml
Assembly: System.Xml (in system.xml.dll)

Sintassi
Visual Basic - (Dichiarazione)
Public Property EntityHandling As EntityHandling
Visual Basic (Utilizzo)
Dim instance As XmlTextReader
Dim value As EntityHandling

value = instance.EntityHandling

instance.EntityHandling = value
C#
public EntityHandling EntityHandling { get; set; }
C++
public:
property EntityHandling EntityHandling {
	EntityHandling get ();
	void set (EntityHandling value);
}
J#
/** @property */
public EntityHandling get_EntityHandling ()

/** @property */
public void set_EntityHandling (EntityHandling value)
JScript
public function get EntityHandling () : EntityHandling

public function set EntityHandling (value : EntityHandling)

Valore proprietà

Uno dei valori di EntityHandling. Se non viene specificato alcun EntityHandling, viene utilizzato il valore predefinito EntityHandling.ExpandCharEntities.
Note
NotaNota

Nella versione Microsoft .NET Framework versione 2.0 è consigliabile creare istanze di XmlReader utilizzando il metodo System.Xml.XmlReader.Create. In questo modo è possibile sfruttare completamente le nuove funzionalità introdotte in questa versione. Per ulteriori informazioni, vedere Creazione di lettori XML.

È possibile modificare questa proprietà in tempo reale e rendere effettive le modifiche una volta eseguita la successiva chiamata al metodo Read.

Se la proprietà EntityHandling è impostata su ExpandCharEntities, i valori degli attributi vengono normalizzati solo in modo parziale. Il visualizzatore esegue la normalizzazione dei singoli nodi di testo indipendentemente dal contenuto dei nodi dei riferimenti alle entità adiacenti.

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

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

Quando la proprietà EntityHandling è impostata su ExpandEntities, il nodo elemento "doc" contiene un nodo testo con il testo dell'entità espansa:

Profondità

Tipo di nodo

Nome

Valore

1

Text

A 123

Quando la proprietà EntityHandling è impostata su ExpandCharEntites e la proprietà WhitespaceHandling è impostata su Significant o All, l'elemento "doc" espande l'entità di caratteri e restituisce l'entità generale sotto forma di nodo:

Profondità

Tipo di nodo

Nome

Valore

1

Text

A

1

EntityReference

num

1

SignificantWhitespace

Piattaforme

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile per Pocket PC, Windows Mobile per Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.

Informazioni sulla versione

.NET Framework

Supportato in: 2.0

.NET Compact Framework

Supportato in: 2.0
Vedere anche