XmlReader.ReadContentAsDateTime XmlReader.ReadContentAsDateTime XmlReader.ReadContentAsDateTime XmlReader.ReadContentAsDateTime Method

Definición

Lee el contenido de texto en la posición actual como un objeto DateTime.Reads the text content at the current position as a DateTime object.

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

El contenido del texto como objeto DateTime.The text content as a DateTime object.

Excepciones

La conversión intentada no es válida.The attempted cast is not valid.

El formato de la cadena no es válido.The string format is not valid.

Se llamó un método XmlReader antes de que se termine una operación asincrónica anterior.An XmlReader method was called before a previous asynchronous operation finished. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Comentarios

Este método concatena las secciones de texto, espacio en blanco, espacio en blanco significativo y CDATA, y omite cualquier comentario o instrucción de procesamiento.This method concatenates text, white space, significant white space, and CDATA sections, and skips any comments or processing instructions. Las referencias de entidad se resuelven automáticamente.Entity references are automatically resolved.

Si el contenido se escribe xsd:dateTime, el lector devuelve un objeto desempaquetado. DateTimeIf the content is typed xsd:dateTime, the reader returns an unboxed DateTime object. Si no se escribe xsd:dateTimeel contenido, el lector intenta convertirlo en un DateTime objeto de acuerdo con las reglas definidas por la parte 2 del esquema XML del consorcio W3C: Recomendación de tipos de los tipos de.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.

Nota

No puede confiar en el valor de DateTime.Year si el contenido tiene el tipo xsd:gMonthDay.You cannot rely on the DateTime.Year value when the content is typed as xsd:gMonthDay. XmlReadersiempre establece el DateTime.Year valor en 1904 en este caso.XmlReader always sets the DateTime.Year value to 1904 in this case.

En la tabla siguiente se describe cómo trata este método cada tipo de nodo.The following table describes how this method treats each node type.

Tipo XmlNodeXmlNodeType Valor devueltoReturn value Comportamiento del sistema de lecturaReader behavior
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.Concatenated content of text, CDATA, white space and significant white space nodes converted to the requested type. Se mueve a la siguiente etiqueta del elemento de inicio o de fin.Moves to the next start element or end element tag. Las referencias de entidad se expanden automáticamente.Entity references are automatically expanded.
Attribute Igual que llamar XmlConvert.ToXxx a en el valor del atributo.Same as calling XmlConvert.ToXxx on the attribute value. El sistema de lectura permanece en la posición actual.The reader remains in the current position.
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.Ignores the processing instruction (PI) or comment and reads the concatenated text content that follows the PI or comment. Se mueve a la siguiente etiqueta del elemento de inicio o de fin.Moves to the next start element or end element tag. Las referencias de entidad se expanden automáticamente.Entity references are automatically expanded.
EndElement Una cadena vacía.An empty string. El sistema de lectura permanece en la posición actual.The reader remains in the current position.
Element

XmlDeclaration

None

Document

DocumentType

Notation

Entity

DocumentFragment
Se inicia una InvalidOperationException.An InvalidOperationException is thrown. No definido, aunque normalmente el sistema de lectura permanece en la posición actual.Undefined, although typically the reader remains in the current position.

Para obtener más información, vea XmlReader la página de referencia y el esquema XML de W3C parte 2: Recomendación de tipos de los tipos de.For more information, see the XmlReader reference page and the W3C XML Schema Part 2: Datatypes recommendation.

Se aplica a