XmlReader.ReadContentAsDateTime Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

System.Xml.ReaderWriter.dll

Sestavení:

System.Xml.dll

Sestavení:

netstandard.dll

Přečte textový obsah na aktuální pozici jako 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

Návraty

DateTime

Textový obsah jako DateTime objekt.

Výjimky

InvalidCastException

Pokus o přetypování není platný.

FormatException

Formát řetězce není platný.

InvalidOperationException

XmlReader Před dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace již probíhá".

Poznámky

Tato metoda zřetězí text, prázdné znaky, významné prázdné znaky a oddíly CDATA a přeskočí všechny komentáře nebo pokyny ke zpracování. Odkazy na entity se automaticky přeloží.

Pokud je obsah zadán xsd:dateTime, čtečka vrátí unboxed DateTime objekt. Pokud obsah není zadán xsd:dateTime, čtenář se pokusí jej převést na DateTime objekt podle pravidel definovaných schématem W3C XML část 2: Doporučení datových typů .

Poznámka

Nelze spoléhat na DateTime.Year hodnotu, pokud je obsah zadán jako xsd:gMonthDay. XmlReader v tomto případě vždy nastaví DateTime.Year hodnotu na hodnotu 1904.

Následující tabulka popisuje, jak tato metoda zpracovává jednotlivé typy uzlů.

Xmlnodetype	Vrácená hodnota	Chování čtenáře
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity	Zřetězený obsah textu, CDATA, prázdných a významných prázdných uzlů převedených na požadovaný typ	Přesune se na další počáteční prvek nebo značku koncového prvku. Odkazy na entity se automaticky rozbalí.
Attribute	Stejné jako volání XmlConvert.ToXxx hodnoty atributu.	Čtenář zůstává na aktuální pozici.
Comment ProcessingInstruction	Ignoruje instrukce zpracování (PI) nebo komentář a přečte zřetězený textový obsah, který následuje za PI nebo komentářem.	Přesune se na další počáteční prvek nebo značku koncového prvku. Odkazy na entity se automaticky rozbalí.
EndElement	Prázdný řetězec.	Čtenář zůstává na aktuální pozici.
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment	Je InvalidOperationException to vyhozeno.	Nedefinováno, i když čtenář obvykle zůstává v aktuální pozici.

Další informace najdete na XmlReader referenční stránce a v části 2 schématu XML W3C: Doporučení datových typů .