XmlReader.ReadElementContentAsLong Método

Definición

Espacio de nombres:

System.Xml

Ensamblado:

System.Xml.ReaderWriter.dll

Ensamblado:

System.Xml.dll

Ensamblado:

netstandard.dll

Lee el elemento actual y devuelve el contenido como entero de 64 bits con signo.

Sobrecargas

ReadElementContentAsLong()	Lee el elemento actual y devuelve el contenido como entero de 64 bits con signo.
ReadElementContentAsLong(String, String)	Comprueba que el nombre local y el identificador URI del espacio de nombres especificados coinciden con los del elemento actual, luego lee el elemento actual y devuelve el contenido como entero de 64 bits con signo.

ReadElementContentAsLong()

Lee el elemento actual y devuelve el contenido como entero de 64 bits con signo.

public:
 virtual long ReadElementContentAsLong();

public virtual long ReadElementContentAsLong ();

abstract member ReadElementContentAsLong : unit -> int64
override this.ReadElementContentAsLong : unit -> int64

Public Overridable Function ReadElementContentAsLong () As Long

Devoluciones

Int64

Contenido del elemento como entero de 64 bits con signo.

Excepciones

InvalidOperationException

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

XmlException

El elemento actual contiene elementos secundarios.

o bien

El contenido del elemento no se puede convertir en un entero de 64 bits con signo.

ArgumentNullException

Se llama al método con argumentos null.

Ejemplos

En el ejemplo siguiente se usa el ReadElementContentAsLong método para leer el contenido del longValue elemento .

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("longValue");
     long number = reader.ReadElementContentAsLong();
     // Do some processing with the number object.
}

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("longValue")
  Dim number As Long = reader.ReadElementContentAsLong()
  ' Do some processing with the number object.
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:long, el lector devuelve un entero de 64 bits con signo de 64 bits. Si el contenido no está escrito xsd:long, el lector intenta convertirlo en un entero de 64 bits con signo según las reglas definidas por la recomendación esquema XML de W3C, parte 2: Tipos de datos .

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

ReadElementContentAsLong(String, String)

Comprueba que el nombre local y el identificador URI del espacio de nombres especificados coinciden con los del elemento actual, luego lee el elemento actual y devuelve el contenido como entero de 64 bits con signo.

public:
 virtual long ReadElementContentAsLong(System::String ^ localName, System::String ^ namespaceURI);

public virtual long ReadElementContentAsLong (string localName, string namespaceURI);

abstract member ReadElementContentAsLong : string * string -> int64
override this.ReadElementContentAsLong : string * string -> int64

Public Overridable Function ReadElementContentAsLong (localName As String, namespaceURI As String) As Long

Parámetros

localName

String

Nombre local del elemento.

namespaceURI

String

Identificador URI de espacio de nombres del elemento.

Devoluciones

Int64

El elemento contiene un entero de 64 bits con signo.

Excepciones

InvalidOperationException

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

XmlException

El elemento actual contiene elementos secundarios.

o bien

El contenido del elemento no se puede convertir en un entero de 64 bits con signo.

ArgumentNullException

Se llama al método con argumentos null.

ArgumentException

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:long, el lector devuelve un entero de 64 bits con signo de 64 bits sin conversiónboxing. Si el contenido no está escrito xsd:long, el lector intenta convertirlo en un entero de 64 bits con signo según las reglas definidas por la recomendación W3C XML Schema Part 2: Datatypes .

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