XmlReader.ReadElementContentAsDateTime XmlReader.ReadElementContentAsDateTime XmlReader.ReadElementContentAsDateTime XmlReader.ReadElementContentAsDateTime Method

Definición

Lee el elemento actual y devuelve el contenido como un objeto DateTime.Reads the current element and returns the contents as a DateTime object.

Sobrecargas

ReadElementContentAsDateTime() ReadElementContentAsDateTime() ReadElementContentAsDateTime() ReadElementContentAsDateTime()

Lee el elemento actual y devuelve el contenido como un objeto DateTime.Reads the current element and returns the contents as a DateTime object.

ReadElementContentAsDateTime(String, String) ReadElementContentAsDateTime(String, String) ReadElementContentAsDateTime(String, String) 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.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() ReadElementContentAsDateTime() ReadElementContentAsDateTime() ReadElementContentAsDateTime()

Lee el elemento actual y devuelve el contenido como un objeto 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

Devoluciones

Contenido de elemento como objeto DateTime.The element content as a DateTime object.

Excepciones

El XmlReader no está situado en ningún elemento.The XmlReader is not positioned on an element.

o bien-or-

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

El elemento actual contiene elementos secundarios.The current element contains child elements.

O bien-or- El contenido de elemento no puede convertirse en un objeto DateTime.The element content cannot be converted to a DateTime object.

Se llama al método con argumentos null.The method is called with null arguments.

Ejemplos

En el ejemplo siguiente se ReadElementContentAsDateTime usa el método para leer el contenido date del elemento.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

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

Comentarios

Este método lee la etiqueta de apertura, el contenido del elemento y desplaza el lector más allá de la etiqueta del elemento final.This method reads the start tag, the contents of the element, and moves the reader past the end element tag. Expande las entidades y omite las instrucciones de procesamiento y los comentarios.It expands entities and ignores processing instructions and comments. El elemento solo puede contener contenido simple.The element can only contain simple content. Es decir, no puede tener elementos secundarios.That is, it cannot have child elements.

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.

Para obtener más información, vea la sección Comentarios de la página de referencia de XmlReader.For more information, see the Remarks section of the XmlReader reference page.

ReadElementContentAsDateTime(String, String) ReadElementContentAsDateTime(String, String) ReadElementContentAsDateTime(String, String) 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.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

Parámetros

localName
String String String String

Nombre local del elemento.The local name of the element.

namespaceURI
String String String String

Identificador URI de espacio de nombres del elemento.The namespace URI of the element.

Devoluciones

El contenido del elemento como objeto DateTime.The element contents as a DateTime object.

Excepciones

El XmlReader no está situado en ningún elemento.The XmlReader is not positioned on an element.

O bien-or-

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

El elemento actual contiene elementos secundarios.The current element contains child elements.

O bien-or-

El contenido del elemento no se puede convertir en el tipo solicitado.The element content cannot be converted to the requested type.

Se llama al método con argumentos null.The method is called with null arguments.

El nombre local y el identificador URI del espacio de nombres especificados no coinciden con los del elemento que se está leyendo.The specified local name and namespace URI do not match that of the current element being read.

Comentarios

Este método lee la etiqueta de apertura, el contenido del elemento y desplaza el lector más allá de la etiqueta del elemento final.This method reads the start tag, the contents of the element, and moves the reader past the end element tag. Expande las entidades y omite las instrucciones de procesamiento y los comentarios.It expands entities and ignores processing instructions and comments. El elemento solo puede contener contenido simple.The element can only contain simple content. Es decir, no puede tener elementos secundarios.That is, it cannot have child elements.

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.

Para obtener más información, vea la sección Comentarios de la página de referencia de XmlReader.For more information, see the Remarks section of the XmlReader reference page.

Se aplica a