XmlReader.ReadElementContentAsLong Méthode

  • Référence

Définition

Espace de noms:
System.Xml
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Lit l’élément actuel et retourne le contenu comme un entier signé de 64 bits.

Surcharges

ReadElementContentAsLong()

Lit l’élément actuel et retourne le contenu comme un entier signé de 64 bits.
ReadElementContentAsLong(String, String)

Vérifie que le nom local spécifié et l’URI de l’espace de noms correspondent à ceux de l’élément actuel, puis lit l’élément actuel et retourne le contenu en tant qu’entier signé de 64 bits.

ReadElementContentAsLong()

Lit l’élément actuel et retourne le contenu comme un entier signé 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

Retours

Int64

Contenu d’élément sous la forme d’un entier signé de 64 bits.

Exceptions

InvalidOperationException

XmlReader n'est pas placé sur un élément.

  • ou -

Une méthode XmlReader a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».

XmlException

L'élément en cours contient des éléments enfants.

  • ou -

Le contenu de l’élément ne peut pas être converti en entier signé de 64 bits.

ArgumentNullException

La méthode est appelée avec des arguments null.

Exemples

L’exemple suivant utilise la ReadElementContentAsLong méthode pour lire le contenu de l’élément 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'exemple prend le fichier dataFile.xml comme entrée.

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

Remarques

Cette méthode lit la balise de début, le contenu de l’élément et déplace le lecteur au-delà de la balise d’élément de fin. Il développe les entités et ignore les instructions de traitement et les commentaires. L’élément ne peut contenir que du contenu simple. Autrement dit, il ne peut pas avoir d’éléments enfants.

Si le contenu est typé xsd:long, le lecteur retourne un entier signé 64 bits nonboxé. Si le contenu n’est pas typé xsd:long, le lecteur tente de le convertir en entier signé 64 bits conformément aux règles définies par la partie 2 du schéma XML W3C : recommandation de types de données .

Pour plus d'informations, consultez la section Notes de la page de référence XmlReader.

S’applique à

ReadElementContentAsLong(String, String)

Vérifie que le nom local spécifié et l’URI de l’espace de noms correspondent à ceux de l’élément actuel, puis lit l’élément actuel et retourne le contenu en tant qu’entier signé 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

Paramètres

localName
String

Le nom local de l'élément.

namespaceURI
String

L'URI de l'espace de noms de l'élément.

Retours

Int64

Contenu d'élément sous la forme d'un entier signé de 64 bits.

Exceptions

InvalidOperationException

XmlReader n'est pas placé sur un élément.

  • ou -

Une méthode XmlReader a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».

XmlException

L'élément en cours contient des éléments enfants.

  • ou -

Le contenu de l’élément ne peut pas être converti en entier signé de 64 bits.

ArgumentNullException

La méthode est appelée avec des arguments null.

ArgumentException

Le nom local et l'URI de l'espace de noms spécifiés ne correspondent pas à l'élément actuel lu.

Remarques

Cette méthode lit la balise de début, le contenu de l’élément et déplace le lecteur au-delà de la balise d’élément de fin. Il développe les entités et ignore les instructions de traitement et les commentaires. L’élément ne peut contenir que du contenu simple. Autrement dit, il ne peut pas avoir d’éléments enfants.

Si le contenu est typé xsd:long, le lecteur retourne un entier signé 64 bits nonboxé. Si le contenu n’est pas typé xsd:long, le lecteur tente de le convertir en entier signé 64 bits conformément aux règles définies par la partie 2 du schéma XML W3C : recommandation de types de données .

Pour plus d'informations, consultez la section Notes de la page de référence XmlReader.

S’applique à