XmlReader.ReadElementContentAsDateTime Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Xml.ReaderWriter.dll

Zestaw:

System.Xml.dll

Zestaw:

netstandard.dll

Odczytuje bieżący element i zwraca zawartość jako DateTime obiekt.

Przeciążenia

ReadElementContentAsDateTime()	Odczytuje bieżący element i zwraca zawartość jako DateTime obiekt.
ReadElementContentAsDateTime(String, String)	Sprawdza, czy określona nazwa lokalna i identyfikator URI przestrzeni nazw jest zgodna z bieżącym elementem DateTime , a następnie odczytuje bieżący element i zwraca zawartość jako obiekt.

ReadElementContentAsDateTime()

Odczytuje bieżący element i zwraca zawartość jako DateTime obiekt.

C#

public virtual DateTime ReadElementContentAsDateTime ();

Zwraca

DateTime

Zawartość elementu jako DateTime obiekt.

Wyjątki

InvalidOperationException

Element XmlReader nie jest umieszczony na elemecie .

-lub-

Metoda XmlReader została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W tym przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

XmlException

Bieżący element zawiera elementy podrzędne.

-lub-

Nie można przekonwertować zawartości elementu na DateTime obiekt.

ArgumentNullException

Metoda jest wywoływana z null argumentami.

Przykłady

W poniższym przykładzie użyto ReadElementContentAsDateTime metody do odczytania zawartości date elementu.

C#

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());
}

W przykładzie użyto dataFile.xml pliku jako danych wejściowych.

XML

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

Uwagi

Ta metoda odczytuje tag startowy, zawartość elementu i przenosi czytnik obok tagu elementu końcowego. Rozszerza jednostki i ignoruje przetwarzanie instrukcji i komentarzy. Element może zawierać tylko prostą zawartość. Oznacza to, że nie może mieć elementów podrzędnych.

Jeśli zawartość jest typowana xsd:dateTime, czytnik zwraca obiekt rozpboxowany DateTime . Jeśli zawartość nie jest wpisywana xsd:dateTime, czytelnik próbuje przekonwertować go na DateTime obiekt zgodnie z regułami zdefiniowanymi przez zalecenie schematu XML W3C Part 2: Datatypes .

Uwaga

Nie można polegać na DateTime.Year wartości, gdy zawartość jest wpisywana jako xsd:gMonthDay. XmlReader zawsze ustawia DateTime.Year wartość 1904 w tym przypadku.

Aby uzyskać więcej informacji, zobacz sekcję Uwagi na stronie referencyjnej XmlReader .

ReadElementContentAsDateTime(String, String)

Sprawdza, czy określona nazwa lokalna i identyfikator URI przestrzeni nazw jest zgodna z bieżącym elementem DateTime , a następnie odczytuje bieżący element i zwraca zawartość jako obiekt.

C#

public virtual DateTime ReadElementContentAsDateTime (string localName, string namespaceURI);

Parametry

localName

String

Lokalna nazwa elementu.

namespaceURI

String

Identyfikator URI przestrzeni nazw elementu.

Zwraca

DateTime

Zawartość elementu jako DateTime obiekt.

Wyjątki

InvalidOperationException

Element XmlReader nie jest umieszczony na elemecie.

-lub-

Metoda XmlReader została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W tym przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

XmlException

Bieżący element zawiera elementy podrzędne.

-lub-

Nie można przekonwertować zawartości elementu na żądany typ.

ArgumentNullException

Metoda jest wywoływana z null argumentami.

ArgumentException

Określona nazwa lokalna i identyfikator URI przestrzeni nazw nie są zgodne z bieżącym elementem odczytywanym.

Uwagi

Ta metoda odczytuje tag startowy, zawartość elementu i przenosi czytnik obok tagu elementu końcowego. Rozszerza jednostki i ignoruje instrukcje przetwarzania i komentarze. Element może zawierać tylko prostą zawartość. Oznacza to, że nie może mieć elementów podrzędnych.

Jeśli zawartość jest typowana xsd:dateTime, czytnik zwraca obiekt bez skrzynki odbiorczej DateTime . Jeśli zawartość nie jest typowana xsd:dateTime, czytelnik próbuje przekonwertować go na DateTime obiekt zgodnie z regułami zdefiniowanymi przez zalecenie schematu XML W3C — część 2: Danetypy .

Uwaga

Nie można polegać na DateTime.Year wartości, gdy zawartość jest wpisywana jako xsd:gMonthDay. XmlReader zawsze ustawia DateTime.Year wartość na 1904 w tym przypadku.

Aby uzyskać więcej informacji, zobacz sekcję Uwagi na stronie referencyjnej XmlReader .