XmlReader.ReadElementContentAsLong Método

Definição

Espaço de Nomes:
System.Xml
Assemblagens:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.dll
Assemblagem:
System.Xml.ReaderWriter.dll
Assemblagem:
netstandard.dll

Lê o elemento atual e devolve o conteúdo como um inteiro assinado de 64 bits.

Sobrecargas

Name Description
ReadElementContentAsLong()

Lê o elemento atual e devolve o conteúdo como um inteiro assinado de 64 bits.
ReadElementContentAsLong(String, String)

Verifica se o nome local especificado e o URI do espaço de nomes correspondem ao do elemento atual, depois lê o elemento atual e devolve o conteúdo como um inteiro assinado de 64 bits.

ReadElementContentAsLong()

Lê o elemento atual e devolve o conteúdo como um inteiro assinado de 64 bits.

public:
 virtual long ReadElementContentAsLong();
public virtual long ReadElementContentAsLong();
abstract member ReadElementContentAsLong : unit -> int64
override this.ReadElementContentAsLong : unit -> int64
Public Overridable Function ReadElementContentAsLong () As Long

Devoluções

Int64

O elemento conteúdo é um inteiro assinado de 64 bits.

Exceções

InvalidOperationException

O XmlReader não está posicionado sobre um elemento.

-ou-

Um XmlReader método era chamado antes de uma operação assíncrona anterior terminar. Neste caso, InvalidOperationException é lançado com a mensagem "Uma operação assíncrona já está em curso."

XmlException

O elemento atual contém elementos filhos.

-ou-

O conteúdo dos elementos não pode ser convertido para um inteiro com sinal de 64 bits.

ArgumentNullException

O método é chamado com null argumentos.

Exemplos

O exemplo seguinte utiliza o ReadElementContentAsLong método para ler o conteúdo do 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

O exemplo usa o dataFile.xml ficheiro como entrada.

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

Observações

Este método lê a etiqueta inicial, o conteúdo do elemento e move o leitor para além da etiqueta do elemento final. Expande entidades e ignora instruções e comentários de processamento. O elemento só pode conter conteúdo simples. Ou seja, não pode ter elementos filhos.

Se o conteúdo for digitado xsd:long, o leitor devolve um inteiro assinado de 64 bits sem caixa. Se o conteúdo não for tipado xsd:long, o leitor tenta convertê-lo para um inteiro assinado de 64 bits de acordo com as regras definidas pela recomendação do Esquema XML do W3C Parte 2: Tipos de dados .

Para obter mais informações, consulte a seção Comentários da XmlReader página de referência.

Aplica-se a

ReadElementContentAsLong(String, String)

Verifica se o nome local especificado e o URI do espaço de nomes correspondem ao do elemento atual, depois lê o elemento atual e devolve o conteúdo como um inteiro assinado de 64 bits.

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

O nome local do elemento.

namespaceURI
String

O URI do namespace do elemento.

Devoluções

Int64

O elemento conteúdo é um inteiro assinado de 64 bits.

Exceções

InvalidOperationException

O XmlReader não está posicionado sobre um elemento.

-ou-

Um XmlReader método era chamado antes de uma operação assíncrona anterior terminar. Neste caso, InvalidOperationException é lançado com a mensagem "Uma operação assíncrona já está em curso."

XmlException

O elemento atual contém elementos filhos.

-ou-

O conteúdo dos elementos não pode ser convertido para um inteiro com sinal de 64 bits.

ArgumentNullException

O método é chamado com null argumentos.

ArgumentException

O nome local especificado e o URI do espaço de nomes não correspondem ao do elemento atual a ser lido.

Observações

Este método lê a etiqueta inicial, o conteúdo do elemento e move o leitor para além da etiqueta do elemento final. Expande entidades e ignora instruções e comentários de processamento. O elemento só pode conter conteúdo simples. Ou seja, não pode ter elementos filhos.

Se o conteúdo for digitado xsd:long, o leitor devolve um inteiro assinado de 64 bits sem caixa. Se o conteúdo não for tipado xsd:long, o leitor tenta convertê-lo para um inteiro assinado de 64 bits de acordo com as regras definidas pela recomendação do Esquema XML do W3C Parte 2: Tipos de dados .

Para obter mais informações, consulte a seção Comentários da XmlReader página de referência.

Aplica-se a