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.

public:
 virtual DateTime ReadElementContentAsDateTime();

public virtual DateTime ReadElementContentAsDateTime ();

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

Public Overridable Function ReadElementContentAsDateTime () As DateTime

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.

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

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

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

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

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 .