XmlReader.ReadContentAsObject Methode
Definition
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 -> objPublic Overridable Function ReadContentAsObject () As ObjectGibt zurück
Der Textinhalt als das am besten geeignete Common Language Runtime (CLR)-Objekt.
Ausnahmen
Die versuchte Umwandlung ist ungültig.
Das Zeichenfolgenformat ist ungültig.
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.
Wenn der Inhalt eingegeben wird, gibt der Leser einen boxierten CLR des am besten geeigneten Typs zurück, der durch die ValueType Eigenschaft angegeben wird. Wenn der Inhalt ein Listentyp ist, gibt der Leser ein Array von Boxobjekten des entsprechenden Typs zurück.
Hinweis
Wenn beim Analysieren des Inhalts ein Überprüfungsfehler auftritt und der Leser ein XmlReader objekt ist, das von der Create Methode erstellt wurde, gibt der Leser den Inhalt als Zeichenfolge zurück. Mit anderen Worten, wenn ein Überprüfungsfehler oder eine Warnung auftritt, wird der Inhalt als untypiert betrachtet.
Wenn der Inhalt nicht eingegeben wird, gibt der Leser den Inhalt als Zeichenfolge zurück.
In der folgenden Tabelle wird beschrieben, wie diese Methode jeden Knotentyp behandelt.
| Xmlnodetype | Rückgabewert | Leseverhalten |
|---|---|---|
TextCDATAWhitespaceSignificantWhitespaceEntityReferenceEndEntity |
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. |
CommentProcessingInstruction |
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 |
Der Wert des Elements, wenn es sich beim Reader um einen Schemaüberprüfungsleser handelt (ValidationType ist auf festgelegt Schema), andernfalls eine leere Zeichenfolge. | Der Leser verbleibt an der aktuellen Position. |
ElementXmlDeclarationNoneDocumentDocumentTypeNotationEntityDocumentFragment |
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 ReadContentAsObjectAsync.
