XmlReader.ReadContentAsString Metodo

Definizione

Spazio dei nomi:
System.Xml
Assembly:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assembly:
netstandard.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll
Origine:
XmlReader.cs
Origine:
XmlReader.cs
Origine:
XmlReader.cs
Origine:
XmlReader.cs
Origine:
XmlReader.cs

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

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

Valori restituiti

String

Contenuto di testo come String oggetto .

Eccezioni

InvalidCastException

Il cast tentato non è valido.

FormatException

Formato stringa non valido.

InvalidOperationException

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

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 usato per convertire i valori tipizzati in una stringa o per leggere il contenuto di testo ignorando i commenti e le istruzioni di elaborazione.

Nella tabella seguente viene descritto come questo metodo gestisce ogni tipo di nodo.

Xmlnodetype Valore restituito Comportamento lettore
Text

CDATA

Whitespace

SignificantWhitespace

EntityReference

EndEntity		 Contenuto concatenato di testo, CDATA, spazi vuoti e nodi di spazi vuoti significativi convertiti nel tipo richiesto. Passa al tag dell'elemento iniziale o dell'elemento finale successivo. I riferimenti alle entità vengono espansi automaticamente.
Attribute Uguale alla chiamata XmlConvert.ToXxx al valore dell'attributo. Il lettore rimane nella posizione corrente.
Comment

ProcessingInstruction		 Ignora l'istruzione di elaborazione o il commento e legge il contenuto di testo concatenato che segue il PI o il commento. Passa al tag dell'elemento iniziale o dell'elemento finale successivo. I riferimenti alle entità vengono espansi automaticamente.
EndElement Stringa vuota. Il lettore rimane nella posizione corrente.
Element

XmlDeclaration

None

Document

DocumentType

Notation

Entity

DocumentFragment		 Viene generata un'eccezione InvalidOperationException . Non definito, anche se in genere il lettore rimane 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.

Si applica a