Freigeben über


XmlReader.ReadContentAsObject Methode

Definition

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

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