XmlReader.ReadElementContentAsDateTime Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

System.Xml.ReaderWriter.dll

Sestavení:

System.Xml.dll

Sestavení:

netstandard.dll

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

Přetížení

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

ReadElementContentAsDateTime()

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

-nebo-

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á".

XmlException

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

-nebo-

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

ArgumentNullException

Metoda se volá 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. Rozbalí entity a ignoruje pokyny a komentáře ke zpracování. 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í ho 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 hodnotu, DateTime.Year pokud je obsah zadán jako xsd:gMonthDay. XmlReader v tomto případě vždy nastaví DateTime.Year hodnotu na hodnotu 1904.

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

ReadElementContentAsDateTime(String, String)

Zkontroluje, jestli zadaný místní název a identifikátor URI oboru názvů odpovídá identifikátoru URI aktuálního 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 DateTime jako objekt.

Výjimky

InvalidOperationException

Není XmlReader umístěn na elementu.

-nebo-

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á".

XmlException

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

-nebo-

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

ArgumentNullException

Metoda se volá s null argumenty.

ArgumentException

Zadaný místní název a identifikátor URI oboru názvů neodpovídá identifikátoru URI aktuálního prvku, který se čte.

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

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.

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