XmlReader.ReadContentAsLong Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Lit le contenu du texte à la position actuelle sous la forme d’un entier signé 64 bits.
public:
virtual long ReadContentAsLong();
public virtual long ReadContentAsLong();
abstract member ReadContentAsLong : unit -> int64
override this.ReadContentAsLong : unit -> int64
Public Overridable Function ReadContentAsLong () As Long
Retours
Contenu texte sous la forme d’un entier signé 64 bits.
Exceptions
La tentative de cast n’est pas valide.
Le format de chaîne n’est pas valide.
Une XmlReader méthode a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».
Remarques
Cette méthode concatène du texte, de l’espace blanc, de l’espace blanc significatif et des sections CDATA, et ignore les commentaires ou instructions de traitement. Les références d’entité sont résolues automatiquement.
Si le contenu est tapé 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 en fonction des règles définies par la partie 2 du schéma XML W3C : recommandation datatypes .
Le tableau suivant décrit cette méthode traite chaque type de nœud.
| XmlNodeType | Valeur renvoyée | Comportement du lecteur |
|---|---|---|
TextCDATAWhitespaceSignificantWhitespaceEntityReferenceEndEntity |
Contenu concaténé de texte, CDATA, espace blanc et nœuds d’espace blanc significatifs convertis en type demandé. | Passe à l’élément de début ou à la balise d’élément de fin suivant. Les références d’entité sont automatiquement développées. |
Attribute |
Identique à XmlConvert.ToXxx la valeur de l’attribut. |
Le lecteur reste à la position actuelle |
CommentProcessingInstruction |
Ignore l’instruction de traitement (PI) ou le commentaire et lit le contenu de texte concaténé qui suit le pi ou le commentaire. | Passe à l’élément de début ou à la balise d’élément de fin suivant. Les références d’entité sont automatiquement développées. |
EndElement |
Chaîne vide. | Le lecteur reste à la position actuelle. |
ElementXmlDeclarationNoneDocumentDocumentTypeNotationEntityDocumentFragment |
Une InvalidOperationException est levée. | Non défini, bien que le lecteur reste généralement dans la position actuelle. |
Pour plus d'informations, consultez la section Notes de la page de référence XmlReader.