XmlReader.ReadContentAsDateTime Metódus

Definíció

Névtér:

System.Xml

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Forrás:

XmlReader.cs

Beolvassa a szöveges tartalmat az aktuális pozícióban objektumként DateTime .

public:
 virtual DateTime ReadContentAsDateTime();

public virtual DateTime ReadContentAsDateTime();

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

Public Overridable Function ReadContentAsDateTime () As DateTime

Válaszok

DateTime

A szöveges tartalom objektumként DateTime .

Kivételek

InvalidCastException

A megkísérelt szereposztás érvénytelen.

FormatException

A sztring formátuma érvénytelen.

InvalidOperationException

Egy XmlReader metódust hívtak meg, mielőtt egy korábbi aszinkron művelet befejeződött. Ebben az esetben InvalidOperationException a "Aszinkron művelet már folyamatban van" üzenet jelenik meg.

Megjegyzések

Ez a módszer összefűzi a szöveget, a szóközt, a jelentős üres területet és a CDATA-szakaszokat, és kihagyja a megjegyzéseket és a feldolgozási utasításokat. Az entitáshivatkozások automatikusan feloldódnak.

Ha a tartalom be van állítva xsd:dateTime, az olvasó egy nem beérkezett objektumot ad DateTime vissza. Ha a tartalom nincs begépelve xsd:dateTime, az olvasó megpróbálja azt objektummá alakítani DateTime a W3C XML-séma 2. része: Adattípusokra vonatkozó javaslat által meghatározott szabályok szerint.

Note

A tartalom beírásakor nem támaszkodhat az DateTime.Year értékre xsd:gMonthDay. XmlReader ebben az esetben mindig DateTime.Year 1904 értékre állítja az értéket.

Az alábbi táblázat azt ismerteti, hogy ez a módszer hogyan kezeli az egyes csomóponttípusokat.

XmlNodeType	Visszaadott érték	Olvasói viselkedés
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity	A kért típusra konvertált szöveg, CDATA, fehér terület és jelentős térközcsomópontok összefűzött tartalma.	Ugrás a következő kezdőelemre vagy végelemcímkére. Az entitáshivatkozások automatikusan ki lesznek bontva.
Attribute	Ugyanaz, mint az attribútumérték meghívása XmlConvert.ToXxx .	Az olvasó a jelenlegi helyzetben marad.
Comment ProcessingInstruction	Figyelmen kívül hagyja a feldolgozási utasítást (PI) vagy megjegyzést, és felolvassa a pi vagy megjegyzést követő összefűzött szöveges tartalmat.	Ugrás a következő kezdőelemre vagy végelemcímkére. Az entitáshivatkozások automatikusan ki lesznek bontva.
EndElement	Üres sztring.	Az olvasó a jelenlegi helyzetben marad.
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment	Egy InvalidOperationException van dobva.	Nincs definiálva, bár az olvasó általában a jelenlegi helyzetben marad.

További információkért tekintse meg a XmlReader referencialapot és a W3C XML-séma 2. részét: Adattípusokra vonatkozó javaslatot.