XmlReader.ReadElementContentAsDateTime 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 das aktuelle Element und gibt den Inhalt als DateTime Objekt zurück.
Überlädt
| Name | Beschreibung |
|---|---|
| ReadElementContentAsDateTime() |
Liest das aktuelle Element und gibt den Inhalt als DateTime Objekt zurück. |
| ReadElementContentAsDateTime(String, String) |
Überprüft, ob der angegebene lokale Name und der Namespace-URI mit dem des aktuellen Elements übereinstimmen, dann das aktuelle Element liest und den Inhalt als DateTime Objekt zurückgibt. |
ReadElementContentAsDateTime()
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
Liest das aktuelle Element und gibt den Inhalt als DateTime Objekt zurück.
public:
virtual DateTime ReadElementContentAsDateTime();public virtual DateTime ReadElementContentAsDateTime();abstract member ReadElementContentAsDateTime : unit -> DateTime
override this.ReadElementContentAsDateTime : unit -> DateTimePublic Overridable Function ReadElementContentAsDateTime () As DateTimeGibt zurück
Der Elementinhalt als DateTime Objekt.
Ausnahmen
Die XmlReader Position wird nicht für ein Element positioniert.
- oder -
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.
Das aktuelle Element enthält untergeordnete Elemente.
- oder -
Der Elementinhalt kann nicht in ein DateTime Objekt konvertiert werden.
Die Methode wird mit null Argumenten aufgerufen.
Beispiele
Im folgenden Beispiel wird die ReadElementContentAsDateTime Methode verwendet, um den Inhalt des date Elements zu lesen.
using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
reader.ReadToFollowing("date");
DateTime date = reader.ReadElementContentAsDateTime();
// If the current culture is "en-US",
// this writes "Wednesday, January 8, 2003".
Console.WriteLine(date.ToLongDateString());
}
Using reader As XmlReader = XmlReader.Create("dataFile.xml")
reader.ReadToFollowing("date")
Dim [date] As DateTime = reader.ReadElementContentAsDateTime()
' If the current culture is "en-US",
' this writes "Wednesday, January 8, 2003".
Console.WriteLine([date].ToLongDateString())
End Using
Im Beispiel wird die dataFile.xml Datei als Eingabe verwendet.
<root>
<stringValue>
<!--comment-->
<?some pi?>
text value of the element.
</stringValue>
<longValue>270000000000001</longValue>
<number>0</number>
<double>2E10</double>
<date>2003-01-08T15:00:00-00:00</date>
</root>
Hinweise
Diese Methode liest das Starttag, den Inhalt des Elements und verschiebt den Leser über das Endelementtag. Sie erweitert Entitäten und ignoriert Verarbeitungsanweisungen und Kommentare. Das Element kann nur einfachen Inhalt enthalten. Das heißt, es kann keine untergeordneten Elemente haben.
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, ihn gemäß den von der Empfehlung "W3C XML Schema Part 2: Datatypes" definierten Regeln in ein DateTime Objekt zu konvertieren.
Note
Sie können sich nicht auf den DateTime.Year Wert verlassen, wenn der Inhalt als xsd:gMonthDay getippt wird.
XmlReader legt in diesem Fall immer den DateTime.Year Wert auf 1904 fest.
Weitere Informationen finden Sie im Abschnitt Hinweise auf der XmlReader Referenzseite.
Gilt für:
ReadElementContentAsDateTime(String, String)
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
Überprüft, ob der angegebene lokale Name und der Namespace-URI mit dem des aktuellen Elements übereinstimmen, dann das aktuelle Element liest und den Inhalt als DateTime Objekt zurückgibt.
public:
virtual DateTime ReadElementContentAsDateTime(System::String ^ localName, System::String ^ namespaceURI);public virtual DateTime ReadElementContentAsDateTime(string localName, string namespaceURI);abstract member ReadElementContentAsDateTime : string * string -> DateTime
override this.ReadElementContentAsDateTime : string * string -> DateTimePublic Overridable Function ReadElementContentAsDateTime (localName As String, namespaceURI As String) As DateTimeParameter
- localName
- String
Der lokale Name des Elements.
- namespaceURI
- String
Der Namespace-URI des Elements.
Gibt zurück
Der Elementinhalt als DateTime Objekt.
Ausnahmen
Die XmlReader Position wird nicht für ein Element positioniert.
- oder -
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.
Das aktuelle Element enthält untergeordnete Elemente.
- oder -
Der Elementinhalt kann nicht in den angeforderten Typ konvertiert werden.
Die Methode wird mit null Argumenten aufgerufen.
Der angegebene lokale Name und namespace-URI stimmen nicht mit dem des aktuellen Elements überein, das gelesen wird.
Hinweise
Diese Methode liest das Starttag, den Inhalt des Elements und verschiebt den Leser über das Endelementtag. Sie erweitert Entitäten und ignoriert Verarbeitungsanweisungen und Kommentare. Das Element kann nur einfachen Inhalt enthalten. Das heißt, es kann keine untergeordneten Elemente haben.
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, ihn gemäß den von der Empfehlung "W3C XML Schema Part 2: Datatypes" definierten Regeln in ein DateTime Objekt zu konvertieren.
Note
Sie können sich nicht auf den DateTime.Year Wert verlassen, wenn der Inhalt als xsd:gMonthDay getippt wird.
XmlReader legt in diesem Fall immer den DateTime.Year Wert auf 1904 fest.
Weitere Informationen finden Sie im Abschnitt Hinweise auf der XmlReader Referenzseite.
