XmlReader.ReadContentAsString Methode

Definition

Namespace:: System.Xml

Assemblys:: System.Xml.dll, System.Xml.ReaderWriter.dll

Assemblys:: netstandard.dll, System.Xml.ReaderWriter.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

String

Der Textinhalt als String Objekt.

Ausnahmen

InvalidCastException

Die versuchte Umwandlung ist ungültig.

FormatException

Das Zeichenfolgenformat ist ungültig.

InvalidOperationException

Eine XmlReader Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits ausgeführt" ausgelöst.

Hinweise

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

Diese Methode kann verwendet werden, um eingegebene 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	Zurückgegebener Wert	Leseverhalten
`Text` `CDATA` `Whitespace` `SignificantWhitespace` `EntityReference` `EndEntity`	Verketteter Inhalt von Text, CDATA, Leerzeichen und signifikanten Leerraumknoten, die in den angeforderten Typ konvertiert wurden.	Wechselt zum nächsten Startelement- oder Endelementtag. Entitätsverweise werden automatisch erweitert.
`Attribute`	Identisch mit dem Aufrufen `XmlConvert.ToXxx` des Attributwerts.	Der Leser verbleibt an der aktuellen Position.
`Comment` `ProcessingInstruction`	Ignoriert die Verarbeitungsanweisung (PI) oder den Kommentar und liest den verketteten Textinhalt, der auf die PI oder den Kommentar folgt.	Wechselt zum nächsten Startelement- oder Endelementtag. Entitätsverweise werden automatisch erweitert.
`EndElement`	Eine leere Zeichenfolge.	Der Leser verbleibt an der aktuellen Position.
`Element` `XmlDeclaration` `None` `Document` `DocumentType` `Notation` `Entity` `DocumentFragment`	Es InvalidOperationException wird eingeworfen.	Undefiniert, obwohl der Leser in der Regel an der aktuellen Position bleibt.

Weitere Informationen finden Sie im Abschnitt "Hinweise" der XmlReader Referenzseite und im W3C-XML-Schemateil 2: Empfehlung für Datentypen .

Die asynchrone Version dieser Methode finden Sie unter ReadContentAsStringAsync.

Gilt für:

Feedback

War diese Seite hilfreich?