XmlReader.ReadContentAsDateTime Método

Definición

Espacio de nombres:

System.Xml

Ensamblado:

System.Xml.ReaderWriter.dll

Source:

XmlReader.cs

Lee el contenido de texto en la posición actual como un objeto DateTime.

public:
 virtual DateTime ReadContentAsDateTime();

public virtual DateTime ReadContentAsDateTime ();

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

Public Overridable Function ReadContentAsDateTime () As DateTime

Devoluciones

DateTime

El contenido del texto como objeto DateTime.

Excepciones

InvalidCastException

La conversión intentada no es válida.

FormatException

El formato de la cadena no es válido.

InvalidOperationException

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

Comentarios

Este método concatena texto, espacios en blanco, espacios en blanco significativos y secciones CDATA, y omite los comentarios o las instrucciones de procesamiento. Las referencias de entidad se resuelven automáticamente.

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.

En la tabla siguiente se describe cómo trata este método cada tipo de nodo.

Tipo XmlNode	Valor devuelto	Comportamiento del sistema de lectura
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity	El contenido concatenado de los nodos de texto, CDATA, espacio en blanco y espacio en blanco significativo se convierten en el tipo solicitado.	Se mueve a la siguiente etiqueta del elemento de inicio o de fin. Las referencias de entidad se expanden automáticamente.
Attribute	Igual que llamar a XmlConvert.ToXxx en el valor del atributo.	El sistema de lectura permanece en la posición actual.
Comment ProcessingInstruction	Omite la instrucción de procesamiento o los comentarios y lee el contenido del texto concatenado que sigue a la instrucción de procesamiento o los comentarios.	Se mueve a la siguiente etiqueta del elemento de inicio o de fin. Las referencias de entidad se expanden automáticamente.
EndElement	Una cadena vacía.	El sistema de lectura permanece en la posición actual.
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment	Se inicia una InvalidOperationException.	No definido, aunque normalmente el sistema de lectura permanece en la posición actual.

Para obtener más información, vea la XmlReader página de referencia y la recomendación esquema XML de W3C, parte 2: Tipos de datos .