XmlReader.ReadElementContentAsDateTime Metoda

Definicja

Odczytuje bieżący element i zwraca zawartość jako obiekt DateTime.Reads the current element and returns the contents as a DateTime object.

Przeciążenia

ReadElementContentAsDateTime()

Odczytuje bieżący element i zwraca zawartość jako obiekt DateTime.Reads the current element and returns the contents as a DateTime object.

ReadElementContentAsDateTime(String, String)

Sprawdza, czy określona nazwa lokalna i identyfikator URI przestrzeni nazw są zgodne z bieżącym elementem, a następnie odczytuje bieżący element i zwraca zawartość jako obiekt DateTime.Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a DateTime object.

ReadElementContentAsDateTime()

Odczytuje bieżący element i zwraca zawartość jako obiekt DateTime.Reads the current element and returns the contents as a DateTime object.

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

Zawartość elementu jako obiekt DateTime.The element content as a DateTime object.

Wyjątki

XmlReader nie jest umieszczona w elemencie.The XmlReader is not positioned on an element.

— lub —-or-

Metoda XmlReader została wywołana przed ukończeniem poprzedniej operacji asynchronicznej.An XmlReader method was called before a previous asynchronous operation finished. W takim przypadku InvalidOperationException jest generowany z komunikatem "asynchroniczna operacja jest już w toku".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Bieżący element zawiera elementy podrzędne.The current element contains child elements.

— lub —-or- Zawartości elementu nie można przekonwertować na obiekt DateTime.The element content cannot be converted to a DateTime object.

Metoda jest wywoływana z argumentami null.The method is called with null arguments.

Przykłady

W poniższym przykładzie zastosowano metodę ReadElementContentAsDateTime, aby odczytać zawartość elementu date.The following example uses the ReadElementContentAsDateTime method to read the content of the date element.

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 jest użyty plik dataFile.xml jako dane wejściowe.The example uses the dataFile.xml file as input.

<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 początkowy, zawartość elementu i przenosi czytelnika poza tag elementu końcowego.This method reads the start tag, the contents of the element, and moves the reader past the end element tag. Rozszerza jednostki i ignoruje przetwarzanie instrukcji i komentarzy.It expands entities and ignores processing instructions and comments. Element może zawierać tylko zawartość prostą.The element can only contain simple content. Oznacza to, że nie może mieć elementów podrzędnych.That is, it cannot have child elements.

Jeśli zawartość jest wpisana xsd:dateTime, czytnik zwróci obiekt DateTime nieopakowany.If the content is typed xsd:dateTime, the reader returns an unboxed DateTime object. Jeśli zawartość nie jest wpisana xsd:dateTime, czytelnik próbuje skonwertować go do obiektu DateTime zgodnie z regułami zdefiniowanymi przez plik W3C XML schematu część 2: zalecenie typów danych.If the content is not typed xsd:dateTime, the reader attempts to convert it to a DateTime object according to the rules defined by the W3C XML Schema Part 2: Datatypes recommendation.

Uwaga

Nie można polegać na wartości DateTime.Year, gdy zawartość jest wpisana jako xsd:gMonthDay.You cannot rely on the DateTime.Year value when the content is typed as xsd:gMonthDay. XmlReader zawsze ustawia wartość DateTime.Year na 1904 w tym przypadku.XmlReader always sets the DateTime.Year value to 1904 in this case.

Aby uzyskać więcej informacji, zobacz sekcję uwagi na stronie odniesienia XmlReader.For more information, see the Remarks section of the XmlReader reference page.

ReadElementContentAsDateTime(String, String)

Sprawdza, czy określona nazwa lokalna i identyfikator URI przestrzeni nazw są zgodne z bieżącym elementem, a następnie odczytuje bieżący element i zwraca zawartość jako obiekt DateTime.Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a DateTime object.

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

Nazwa lokalna elementu.The local name of the element.

namespaceURI
String

Identyfikator URI przestrzeni nazw elementu.The namespace URI of the element.

Zwraca

Zawartość elementu jako obiekt DateTime.The element contents as a DateTime object.

Wyjątki

XmlReader nie jest umieszczona w elemencie.The XmlReader is not positioned on an element.

— lub —-or-

Metoda XmlReader została wywołana przed ukończeniem poprzedniej operacji asynchronicznej.An XmlReader method was called before a previous asynchronous operation finished. W takim przypadku InvalidOperationException jest generowany z komunikatem "asynchroniczna operacja jest już w toku".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Bieżący element zawiera elementy podrzędne.The current element contains child elements.

— lub —-or-

Nie można przekonwertować zawartości elementu na żądany typ.The element content cannot be converted to the requested type.

Metoda jest wywoływana z argumentami null.The method is called with null arguments.

Określona nazwa lokalna i identyfikator URI przestrzeni nazw nie są zgodne z bieżącym odczytywanym elementem.The specified local name and namespace URI do not match that of the current element being read.

Uwagi

Ta metoda odczytuje tag początkowy, zawartość elementu i przenosi czytelnika poza tag elementu końcowego.This method reads the start tag, the contents of the element, and moves the reader past the end element tag. Rozszerza jednostki i ignoruje przetwarzanie instrukcji i komentarzy.It expands entities and ignores processing instructions and comments. Element może zawierać tylko zawartość prostą.The element can only contain simple content. Oznacza to, że nie może mieć elementów podrzędnych.That is, it cannot have child elements.

Jeśli zawartość jest wpisana xsd:dateTime, czytnik zwróci obiekt DateTime nieopakowany.If the content is typed xsd:dateTime, the reader returns an unboxed DateTime object. Jeśli zawartość nie jest wpisana xsd:dateTime, czytelnik próbuje skonwertować go do obiektu DateTime zgodnie z regułami zdefiniowanymi przez plik W3C XML schematu część 2: zalecenie typów danych.If the content is not typed xsd:dateTime, the reader attempts to convert it to a DateTime object according to the rules defined by the W3C XML Schema Part 2: Datatypes recommendation.

Uwaga

Nie można polegać na wartości DateTime.Year, gdy zawartość jest wpisana jako xsd:gMonthDay.You cannot rely on the DateTime.Year value when the content is typed as xsd:gMonthDay. XmlReader zawsze ustawia wartość DateTime.Year na 1904 w tym przypadku.XmlReader always sets the DateTime.Year value to 1904 in this case.

Aby uzyskać więcej informacji, zobacz sekcję uwagi na stronie odniesienia XmlReader.For more information, see the Remarks section of the XmlReader reference page.

Dotyczy