XmlReader.ReadContentAsObject Methode

Referenz

Definition

Namespace:: System.Xml

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

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 Object.

public:
 virtual System::Object ^ ReadContentAsObject();

public virtual object ReadContentAsObject ();

abstract member ReadContentAsObject : unit -> obj
override this.ReadContentAsObject : unit -> obj

Public Overridable Function ReadContentAsObject () As Object

Gibt zurück

Object

Der Textinhalt als geeignetstes CLR-Objekt (Common Language Runtime).

Ausnahmen

InvalidCastException

Die versuchte Typumwandlung ist ungültig.

FormatException

Das Zeichenfolgenformat ist nicht gültig.

InvalidOperationException

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 verketten Text, Leerzeichen, erhebliche Leerzeichen und CDATA-Abschnitte und übersprungen alle Kommentare oder Verarbeitungsanweisungen. Entitätsbezüge werden automatisch aufgelöst.

Wenn der Inhalt eingegeben wird, gibt der Leser einen boxed CLR des am besten geeigneten Typs zurück, der von der ValueType Eigenschaft angegeben wird. Wenn der Inhalt ein Listentyp ist, gibt der Leser ein Array von boxierten Objekten des entsprechenden Typs zurück.

Hinweis

Wenn ein Überprüfungsfehler beim Analysieren des Inhalts und der Leser ein XmlReader Objekt ist, das von der Create Methode erstellt wird, gibt der Leser den Inhalt als Zeichenfolge zurück. Mit anderen Worten, wenn ein Überprüfungsfehler oder eine Warnung auftritt, wird der Inhalt als nicht typiert betrachtet.

Wenn der Inhalt nicht typisiert ist, gibt der Reader den Inhalt als Zeichenfolge zurück.

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`	Identisch mit dem Aufrufen `XmlConvert.ToXxx` des Attributwerts.	Der Leser bleibt in der aktuellen Position
`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`	Der Wert des Elements, wenn der Leser ein Schema ist, der auf "Validieren" festgelegt ist (ValidationType ist auf Schema), andernfalls 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 des W3C-XML-Schemas Teil 2: Empfehlung für Datentypen .

Eine asynchrone Version dieser Methode finden Sie unter ReadContentAsObjectAsync.

Gilt für

Teilen über