Compartir vía


XmlReader.ReadElementContentAsDateTime Método

Definición

Lee el elemento actual y devuelve el contenido como un objeto DateTime.

Sobrecargas

ReadElementContentAsDateTime()

Lee el elemento actual y devuelve el contenido como un objeto DateTime.

ReadElementContentAsDateTime(String, String)

Comprueba que el nombre local especificado y el URI del espacio de nombres coinciden con los del elemento actual y, a continuación, lee este elemento y devuelve el contenido como objeto DateTime.

ReadElementContentAsDateTime()

Lee el elemento actual y devuelve el contenido como un objeto DateTime.

public:
 virtual DateTime ReadElementContentAsDateTime();
public virtual DateTime ReadElementContentAsDateTime ();
abstract member ReadElementContentAsDateTime : unit -> DateTime
override this.ReadElementContentAsDateTime : unit -> DateTime
Public Overridable Function ReadElementContentAsDateTime () As DateTime

Devoluciones

DateTime

Contenido de elemento como objeto DateTime.

Excepciones

El XmlReader no está situado en ningún elemento.

o bien

Se llamó un método XmlReader antes de que se termine una operación asincrónica anterior. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.

El elemento actual contiene elementos secundarios.

o bien

El contenido de elemento no puede convertirse en un objeto DateTime.

Se llama al método con argumentos null.

Ejemplos

En el ejemplo siguiente se usa el ReadElementContentAsDateTime método para leer el contenido del date elemento .

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

En el ejemplo se utiliza como entrada el archivo dataFile.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>

Comentarios

Este método lee la etiqueta de inicio, el contenido del elemento y mueve el lector más allá de la etiqueta de elemento final. Expande las entidades y omite las instrucciones de procesamiento y los comentarios. El elemento solo puede contener contenido simple. Es decir, no puede tener elementos secundarios.

Si el contenido se escribe xsd:dateTime, el lector devuelve un objeto sin conversiónboxing DateTime . Si el contenido no está escrito xsd:dateTime, el lector intenta convertirlo en un DateTime objeto según las reglas definidas por la recomendación W3C XML Schema Part 2: Datatypes .

Nota

No puede confiar en el valor de DateTime.Year si el contenido tiene el tipo xsd:gMonthDay. XmlReader siempre establece el DateTime.Year valor en 1904 en este caso.

Para obtener más información, vea la sección Comentarios de la página de referencia de XmlReader.

Se aplica a

ReadElementContentAsDateTime(String, String)

Comprueba que el nombre local especificado y el URI del espacio de nombres coinciden con los del elemento actual y, a continuación, lee este elemento y devuelve el contenido como objeto DateTime.

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

Parámetros

localName
String

Nombre local del elemento.

namespaceURI
String

Identificador URI de espacio de nombres del elemento.

Devoluciones

DateTime

El contenido del elemento como objeto DateTime.

Excepciones

El XmlReader no está situado en ningún elemento.

o bien

Se llamó un método XmlReader antes de que se termine una operación asincrónica anterior. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.

El elemento actual contiene elementos secundarios.

o bien

El contenido del elemento no se puede convertir en el tipo solicitado.

Se llama al método con argumentos null.

El nombre local y el identificador URI del espacio de nombres especificados no coinciden con los del elemento que se está leyendo.

Comentarios

Este método lee la etiqueta de inicio, el contenido del elemento y mueve el lector más allá de la etiqueta de elemento final. Expande las entidades y omite las instrucciones de procesamiento y los comentarios. El elemento solo puede contener contenido simple. Es decir, no puede tener elementos secundarios.

Si el contenido se escribe xsd:dateTime, el lector devuelve un objeto sin conversión boxing DateTime . Si el contenido no está escrito xsd:dateTime, el lector intenta convertirlo en un DateTime objeto según las reglas definidas por la recomendación W3C XML Schema Part 2: Datatypes .

Nota

No puede confiar en el valor de DateTime.Year si el contenido tiene el tipo xsd:gMonthDay. XmlReader siempre establece el DateTime.Year valor en 1904 en este caso.

Para obtener más información, vea la sección Comentarios de la página de referencia de XmlReader.

Se aplica a