XmlReader.ReadContentAsDateTime 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 DateTime-Objekt.

public:
 virtual DateTime ReadContentAsDateTime();

public virtual DateTime ReadContentAsDateTime ();

abstract member ReadContentAsDateTime : unit -> DateTime
override this.ReadContentAsDateTime : unit -> DateTime

Public Overridable Function ReadContentAsDateTime () As DateTime

Gibt zurück

DateTime

Der Textinhalt als DateTime-Objekt.

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 verkettet Text, Leerraum, signifikante Leerzeichen und CDATA-Abschnitte und überspringt Kommentare oder Verarbeitungsanweisungen. Entitätsverweise werden automatisch aufgelöst.

Wenn der Inhalt eingegeben xsd:dateTimewird, gibt der Leser ein unboxiertes DateTime Objekt zurück. Wenn der Inhalt nicht eingegeben xsd:dateTimewird, versucht der Leser, es in ein DateTime Objekt entsprechend den regeln zu konvertieren, die durch den W3C XML-Schemateil 2 definiert sind: Empfehlung für Datentypen .

Hinweis

Wenn der Inhalt den Typ DateTime.Year hat, ist der xsd:gMonthDay-Wert nicht verlässlich. XmlReader Legt in diesem Fall immer den DateTime.Year Wert auf 1904 fest.

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 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 auf der XmlReader Referenzseite und im W3C-XML-Schemateil 2: Empfehlung für Datentypen .

Gilt für

Freigeben über