XmlReader.ReadElementContentAsLong Metodo

Definizione

Spazio dei nomi:

System.Xml

Assembly:

netstandard.dll, System.Xml.ReaderWriter.dll

Legge l'elemento corrente e restituisce il contenuto come intero con segno a 64 bit.

Overload

Nome	Descrizione
ReadElementContentAsLong()	Legge l'elemento corrente e restituisce il contenuto come intero con segno a 64 bit.
ReadElementContentAsLong(String, String)	Verifica che il nome locale e l'URI dello spazio dei nomi specificati corrispondano a quello dell'elemento corrente, quindi legge l'elemento corrente e restituisce il contenuto come intero con segno a 64 bit.

ReadElementContentAsLong()

Origine:

XmlReader.cs

Legge l'elemento corrente e restituisce il contenuto come intero con segno a 64 bit.

public:
 virtual long ReadElementContentAsLong();

public virtual long ReadElementContentAsLong();

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

Public Overridable Function ReadElementContentAsLong () As Long

Valori restituiti

Int64

Contenuto dell'elemento come intero con segno a 64 bit.

Eccezioni

InvalidOperationException

L'oggetto XmlReader non è posizionato su un elemento .

oppure

È stato chiamato un XmlReader metodo prima del completamento di un'operazione asincrona precedente. In questo caso, InvalidOperationException viene generata con il messaggio "Un'operazione asincrona è già in corso".

XmlException

L'elemento corrente contiene elementi figlio.

oppure

Il contenuto dell'elemento non può essere convertito in un intero con segno a 64 bit.

ArgumentNullException

Il metodo viene chiamato con null argomenti.

Esempio

Nell'esempio seguente viene utilizzato il ReadElementContentAsLong metodo per leggere il contenuto dell'elemento longValue .

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

L'esempio usa il dataFile.xml file come 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>

Commenti

Questo metodo legge il tag iniziale, il contenuto dell'elemento e sposta il lettore oltre il tag dell'elemento finale. Espande le entità e ignora le istruzioni di elaborazione e i commenti. L'elemento può contenere solo contenuto semplice. Ovvero, non può avere elementi figlio.

Se il contenuto è tipizzato xsd:long, il lettore restituisce un intero con segno a 64 bit senzaboxing. Se il contenuto non è tipizzato xsd:long, il lettore tenta di convertirlo in un intero con segno a 64 bit in base alle regole definite dalla raccomandazione W3C XML Schema Part 2: Datatypes .

Per altre informazioni, vedere la sezione Note della pagina di riferimento XmlReader.

ReadElementContentAsLong(String, String)

Origine:

XmlReader.cs

Verifica che il nome locale e l'URI dello spazio dei nomi specificati corrispondano a quello dell'elemento corrente, quindi legge l'elemento corrente e restituisce il contenuto come intero con segno a 64 bit.

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

Parametri

localName

String

Nome locale dell'elemento.

namespaceURI

String

URI dello spazio dei nomi dell'elemento.

Valori restituiti

Int64

Contenuto dell'elemento come intero con segno a 64 bit.

Eccezioni

InvalidOperationException

L'oggetto XmlReader non è posizionato su un elemento .

oppure

È stato chiamato un XmlReader metodo prima del completamento di un'operazione asincrona precedente. In questo caso, InvalidOperationException viene generata con il messaggio "Un'operazione asincrona è già in corso".

XmlException

L'elemento corrente contiene elementi figlio.

oppure

Il contenuto dell'elemento non può essere convertito in un intero con segno a 64 bit.

ArgumentNullException

Il metodo viene chiamato con null argomenti.

ArgumentException

Il nome locale e l'URI dello spazio dei nomi specificati non corrispondono a quello dell'elemento corrente letto.

Commenti

Questo metodo legge il tag iniziale, il contenuto dell'elemento e sposta il lettore oltre il tag dell'elemento finale. Espande le entità e ignora le istruzioni di elaborazione e i commenti. L'elemento può contenere solo contenuto semplice. Ovvero, non può avere elementi figlio.

Se il contenuto è tipizzato xsd:long, il lettore restituisce un intero con segno a 64 bit senzaboxing. Se il contenuto non è tipizzato xsd:long, il lettore tenta di convertirlo in un intero con segno a 64 bit in base alle regole definite dalla raccomandazione W3C XML Schema Part 2: Datatypes .

Per altre informazioni, vedere la sezione Note della pagina di riferimento XmlReader.