XmlReader.ReadContentAsString Metodo

Definizione

Spazio dei nomi:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Origine:

XmlReader.cs

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

public:
 virtual System::String ^ ReadContentAsString();

public virtual string ReadContentAsString ();

abstract member ReadContentAsString : unit -> string
override this.ReadContentAsString : unit -> string

Public Overridable Function ReadContentAsString () As String

Restituisce

String

Contenuto di testo come oggetto String.

Eccezioni

InvalidCastException

Il tentativo di cast non è valido.

FormatException

Il formato della stringa non è valido.

InvalidOperationException

È stato chiamato un metodo della classe XmlReader prima del completamento di un'operazione asincrona precedente. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".

Commenti

Questo metodo concatena testo, spazi vuoti, spazi vuoti significativi e sezioni CDATA e ignora eventuali commenti o istruzioni di elaborazione. I riferimenti alle entità vengono risolti automaticamente.

Questo metodo può essere utilizzato per convertire i valori tipizzati in una stringa o per leggere il contenuto del testo ignorando i commenti e le istruzioni di elaborazione.

Nella tabella seguente viene descritto il modo in cui questo metodo gestisce ogni tipo di nodo.

XmlNodeType	Valore restituito	Comportamento del lettore
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity	Contenuto concatenato di nodi di tipo text, CDATA, spazi vuoti e spazi vuoti significativi convertiti nel tipo richiesto.	Si sposta al successivo tag di fine o di inizio dell'elemento. I riferimenti a entità vengono espansi automaticamente.
Attribute	Uguale alla chiamata XmlConvert.ToXxx al valore dell'attributo.	Il lettore 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.	Si sposta al successivo tag di fine o di inizio dell'elemento. I riferimenti a entità vengono espansi automaticamente.
EndElement	Stringa vuota.	Il lettore resta nella posizione corrente.
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment	Viene generato un tipo InvalidOperationException.	Non definito, sebbene in genere il lettore resti nella posizione corrente.

Per altre informazioni, vedere la sezione Osservazioni della XmlReader pagina di riferimento e la raccomandazione W3C XML Schema Part 2: Datatypes .

Per la versione asincrona di questo metodo, vedere ReadContentAsStringAsync.