XmlReader.ReadElementContentAsLong XmlReader.ReadElementContentAsLong XmlReader.ReadElementContentAsLong XmlReader.ReadElementContentAsLong Method

Definición

Lee el elemento actual y devuelve el contenido como entero de 64 bits con signo.Reads the current element and returns the contents as a 64-bit signed integer.

Sobrecargas

ReadElementContentAsLong() ReadElementContentAsLong() ReadElementContentAsLong() ReadElementContentAsLong()

Lee el elemento actual y devuelve el contenido como entero de 64 bits con signo.Reads the current element and returns the contents as a 64-bit signed integer.

ReadElementContentAsLong(String, String) ReadElementContentAsLong(String, String) ReadElementContentAsLong(String, String) 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.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 64-bit signed integer.

ReadElementContentAsLong() ReadElementContentAsLong() ReadElementContentAsLong() ReadElementContentAsLong()

Lee el elemento actual y devuelve el contenido como entero de 64 bits con signo.Reads the current element and returns the contents as a 64-bit signed integer.

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

Contenido del elemento como entero de 64 bits con signo.The element content as a 64-bit signed integer.

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 un entero de 64 bits con signo.The element content cannot be converted to a 64-bit signed integer.

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

Ejemplos

En el ejemplo siguiente se ReadElementContentAsLong usa el método para leer el contenido longValue del elemento.The following example uses the ReadElementContentAsLong method to read the content of the longValue element.

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.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 se escribe xsd:longel contenido, el lector devuelve un entero con signo de 64 bits con la conversión unboxing.If the content is typed xsd:long, the reader returns an unboxed 64-bit signed integer. Si no se escribe xsd:longel contenido, el lector intenta convertirlo en un entero con signo de 64 bits 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:long, the reader attempts to convert it to a 64-bit signed integer according to the rules defined by the W3C XML Schema Part 2: Datatypes recommendation.

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.

ReadElementContentAsLong(String, String) ReadElementContentAsLong(String, String) ReadElementContentAsLong(String, String) 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.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 64-bit signed integer.

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

Contenido del elemento como entero de 64 bits con signo.The element content as a 64-bit signed integer.

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 un entero de 64 bits con signo.The element content cannot be converted to a 64-bit signed integer.

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 se escribe xsd:longel contenido, el lector devuelve un entero con signo de 64 bits con la conversión unboxing.If the content is typed xsd:long, the reader returns an unboxed 64-bit signed integer. Si no se escribe xsd:longel contenido, el lector intenta convertirlo en un entero con signo de 64 bits 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:long, the reader attempts to convert it to a 64-bit signed integer according to the rules defined by the W3C XML Schema Part 2: Datatypes recommendation.

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