Metodo XmlReader.ReadContentAsString (System.Xml)

Cambia visualizzazione:
Classica
Lightweight
ScriptFree
Riferimento a .NET Framework
Metodo XmlReader.ReadContentAsString

Nota: questo metodo è stato introdotto con .NET Framework versione 2.0.

Legge il contenuto di testo nella posizione corrente come oggetto String.

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

Sintassi
Visual Basic - (Dichiarazione)
Public Overridable Function ReadContentAsString As String
Visual Basic (Utilizzo)
Dim instance As XmlReader
Dim returnValue As String

returnValue = instance.ReadContentAsString
C#
public virtual string ReadContentAsString ()
C++
public:
virtual String^ ReadContentAsString ()
J#
public String ReadContentAsString ()
JScript
public function ReadContentAsString () : String

Valore restituito

Contenuto di testo come oggetto String.
Eccezioni
Tipo di eccezione Condizione

InvalidCastException

Il tentativo di cast non è valido.

FormatException

Il formato della stringa non è valido.
Note

In questo metodo vengono concatenati testo, spazio vuoto, spazio vuoto significativo e sezioni CDATA e vengono ignorati commenti o istruzioni di elaborazione. I riferimenti a entità vengono risolti automaticamente.

Questo metodo può essere utilizzato per la conversione di valori tipizzati in stringhe o per la lettura di contenuto di testo ignorando commenti e istruzioni di elaborazione.

Nella tabella riportata di seguito viene illustrato come viene considerato ogni tipo di nodo dal metodo.

XmlNodeType

Valore restituito

Comportamento del visualizzatore

Text

CDATA

Whitespace

SignificantWhitespace

EntityReference

EndEntity

Contenuto concatenato di nodi testo, CDATA, spazi vuoti e spazi vuoti significativi convertiti nel tipo richiesto.

Consente di spostare il successivo tag dell'elemento iniziale o finale. I riferimenti a entità vengono espansi automaticamente.

Attribute

Equivale a chiamare XmlConvert.ToXxx nel valore dell'attributo.

Il visualizzatore resta nella posizione corrente.

Comment

ProcessingInstruction

Ignora l'istruzione di elaborazione (PI, Processing Instruction) o il commento e legge il contenuto del testo concatenato successivo all'istruzione di elaborazione o al commento.

Consente di spostare il successivo tag dell'elemento iniziale o finale. I riferimenti a entità vengono espansi automaticamente.

EndElement

Stringa vuota.

Il visualizzatore resta nella posizione corrente.

Element

XmlDeclaration

None

Document

DocumentType

Notation

Entity

DocumentFragment

Viene generata un'InvalidOperationException.

Non definito, sebbene in genere il visualizzatore resti nella posizione corrente.

Per ulteriori informazioni, vedere Lettura di dati tipizzati e la raccomandazione W3C XML Schema Part 2: Datatypes all'indirizzo http://www.w3.org/TR/xmlschema-2/ (informazioni in lingua inglese).

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