XmlReader.ReadElementContentAsDateTime Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Přečte aktuální prvek a vrátí obsah jako DateTime objekt.

Přetížení

Name	Description
ReadElementContentAsDateTime()	Přečte aktuální prvek a vrátí obsah jako DateTime objekt.
ReadElementContentAsDateTime(String, String)	Zkontroluje, zda zadaný místní název a identifikátor URI oboru názvů odpovídá aktuálnímu prvku, pak přečte aktuální prvek a vrátí obsah jako DateTime objekt.

ReadElementContentAsDateTime()

Zdroj:

XmlReader.cs

Přečte aktuální prvek a vrátí obsah jako DateTime objekt.

public:
 virtual DateTime ReadElementContentAsDateTime();

public virtual DateTime ReadElementContentAsDateTime();

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

Public Overridable Function ReadElementContentAsDateTime () As DateTime

Návraty

DateTime

Obsah elementu jako objekt.DateTime

Výjimky

InvalidOperationException

Není XmlReader umístěn na prvku.

nebo

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

XmlException

Aktuální prvek obsahuje podřízené elementy.

nebo

Obsah elementu nelze převést na DateTime objekt.

ArgumentNullException

Metoda je volána s null argumenty.

Příklady

Následující příklad používá metodu ReadElementContentAsDateTime ke čtení obsahu elementu date .

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

Příklad používá dataFile.xml soubor jako vstup.

<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>

Poznámky

Tato metoda přečte počáteční značku, obsah elementu a přesune čtenáře za značku koncového prvku. Rozšiřuje entity a ignoruje pokyny ke zpracování a komentáře. Prvek může obsahovat pouze jednoduchý obsah. To znamená, že nemůže mít podřízené prvky.

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ů .

Note

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 1904.

Další informace najdete v části Poznámky na XmlReader referenční stránce.

ReadElementContentAsDateTime(String, String)

Zdroj:

XmlReader.cs

Zkontroluje, zda zadaný místní název a identifikátor URI oboru názvů odpovídá aktuálnímu prvku, pak přečte aktuální prvek a vrátí obsah jako DateTime objekt.

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 -> DateTime

Public Overridable Function ReadElementContentAsDateTime (localName As String, namespaceURI As String) As DateTime

Parametry

localName

String

Místní název elementu.

namespaceURI

String

Identifikátor URI oboru názvů elementu.

Návraty

DateTime

Obsah elementu jako objekt.DateTime

Výjimky

InvalidOperationException

Není XmlReader umístěn na prvku.

nebo

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

XmlException

Aktuální prvek obsahuje podřízené elementy.

nebo

Obsah elementu nelze převést na požadovaný typ.

ArgumentNullException

Metoda je volána s null argumenty.

ArgumentException

Zadaný místní název a identifikátor URI oboru názvů se neshodují s aktuálním načteným elementem.

Poznámky

Tato metoda přečte počáteční značku, obsah elementu a přesune čtenáře za značku koncového prvku. Rozšiřuje entity a ignoruje pokyny ke zpracování a komentáře. Prvek může obsahovat pouze jednoduchý obsah. To znamená, že nemůže mít podřízené prvky.

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ů .

Note

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 1904.

Další informace najdete v části Poznámky na XmlReader referenční stránce.