Freigeben über


XmlReader.ReadContentAsString Methode

Definition

Liest den Textinhalt an der aktuellen Position als String-Objekt.

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

Gibt zurück

Der Textinhalt als String-Objekt.

Ausnahmen

Die versuchte Typumwandlung ist ungültig.

Das Zeichenfolgenformat ist nicht gültig.

Eine XmlReader-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.

Hinweise

Diese Methode verkettet Text, Leerraum, signifikante Leerzeichen und CDATA-Abschnitte und überspringt Kommentare oder Verarbeitungsanweisungen. Entitätsverweise werden automatisch aufgelöst.

Diese Methode kann verwendet werden, um typisierte Werte in eine Zeichenfolge zu konvertieren oder den Textinhalt zu lesen, während Kommentare und Verarbeitungsanweisungen übersprungen werden.

In der folgenden Tabelle wird beschrieben, wie diese Methode jeden Knotentyp behandelt.

XmlNodeType Rückgabewert Verhalten des Readers
Text

CDATA

Whitespace

SignificantWhitespace

EntityReference

EndEntity
Verketteter Inhalt von Text, CDATA, Leerraum und signifikantem Leerraumknoten, konvertiert in den angeforderten Typ. Wird zum nächsten Anfangselement- oder Endelementtag verschoben. Entitätsverweise werden automatisch erweitert.
Attribute Dasselbe wie das Aufrufen XmlConvert.ToXxx des Attributwerts. Der Reader behält die aktuelle Position bei.
Comment

ProcessingInstruction
Ignoriert die Verarbeitungsanweisung oder den Kommentar und liest den verketteten Textinhalt, der auf die Verarbeitungsanweisung oder den Kommentar folgt. Wird zum nächsten Anfangselement- oder Endelementtag verschoben. Entitätsverweise werden automatisch erweitert.
EndElement Eine leere Zeichenfolge. Der Reader behält die aktuelle Position bei.
Element

XmlDeclaration

None

Document

DocumentType

Notation

Entity

DocumentFragment
Es wird eine InvalidOperationException ausgelöst. Nicht definiert, der Reader behält jedoch i. d. R. die aktuelle Position bei.

Weitere Informationen finden Sie im Abschnitt Hinweise der XmlReader Referenzseite und in der Empfehlung W3C XML Schema Part 2: Datatypes .

Die asynchrone Version dieser Methode finden Sie unter ReadContentAsStringAsync.

Gilt für: