XmlReader.ReadElementContentAsDateTime Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestawy:

netstandard.dll, System.Xml.ReaderWriter.dll

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

Przeciążenia

Nazwa	Opis
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, a następnie odczytuje bieżący element i zwraca zawartość jako DateTime obiekt.

ReadElementContentAsDateTime()

Źródło:

XmlReader.cs

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 takim 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 date zawartości 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 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 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 .

Note

Nie można polegać na DateTime.Year wartości, gdy zawartość jest typowana 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)

Źródło:

XmlReader.cs

Sprawdza, czy określona nazwa lokalna i identyfikator URI przestrzeni nazw jest zgodna z bieżącym elementem, a następnie odczytuje bieżący element i zwraca zawartość jako DateTime 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 takim 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 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 .

Note

Nie można polegać na DateTime.Year wartości, gdy zawartość jest typowana 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 .