XmlReader.ReadElementContentAsDateTime Método

Definición

Espacio de nombres:

System.Xml

Ensamblados:

netstandard.dll, System.Xml.ReaderWriter.dll

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

Sobrecargas

Nombre	Description
ReadElementContentAsDateTime()	Lee el elemento actual y devuelve el contenido como un DateTime objeto .
ReadElementContentAsDateTime(String, String)	Comprueba que el nombre local especificado y el URI del espacio de nombres coincidan con el del elemento actual y, a continuación, lee el elemento actual y devuelve el contenido como un DateTime objeto .

ReadElementContentAsDateTime()

Source:

XmlReader.cs

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

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 del elemento como un DateTime objeto .

Excepciones

InvalidOperationException

No XmlReader se coloca en un elemento .

O bien

Se llamó a un XmlReader método antes de que finalice una operación asincrónica anterior. En este caso, InvalidOperationException se produce con el mensaje "Una operación asincrónica ya está en curso".

XmlException

El elemento actual contiene elementos secundarios.

O bien

El contenido del elemento no se puede convertir en un DateTime objeto .

ArgumentNullException

Se llama al método con null argumentos.

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 usa el dataFile.xml archivo como entrada.

<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 está escrito xsd:dateTime, el lector devuelve un objeto noboxado 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 .

Note

No puede confiar en el DateTime.Year valor cuando el contenido se escribe como 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.

ReadElementContentAsDateTime(String, String)

Source:

XmlReader.cs

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

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 del espacio de nombres del elemento.

Devoluciones

DateTime

El contenido del elemento como un DateTime objeto .

Excepciones

InvalidOperationException

No XmlReader se coloca en un elemento .

O bien

Se llamó a un XmlReader método antes de que finalice una operación asincrónica anterior. En este caso, InvalidOperationException se produce con el mensaje "Una operación asincrónica ya está en curso".

XmlException

El elemento actual contiene elementos secundarios.

O bien

El contenido del elemento no se puede convertir al tipo solicitado.

ArgumentNullException

Se llama al método con null argumentos.

ArgumentException

El nombre local especificado y el URI del espacio de nombres no coinciden con el del elemento actual 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 está escrito xsd:dateTime, el lector devuelve un objeto noboxado 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 .

Note

No puede confiar en el DateTime.Year valor cuando el contenido se escribe como 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.