XmlNodeReader.ReadElementContentAsBinHex(Byte[], Int32, Int32) Méthode

Définition

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

Lit l’élément et décode le contenu BinHex.

public:
 override int ReadElementContentAsBinHex(cli::array <System::Byte> ^ buffer, int index, int count);
public override int ReadElementContentAsBinHex(byte[] buffer, int index, int count);
override this.ReadElementContentAsBinHex : byte[] * int * int -> int
Public Overrides Function ReadElementContentAsBinHex (buffer As Byte(), index As Integer, count As Integer) As Integer

Paramètres

buffer
Byte[]

Mémoire tampon dans laquelle copier le texte résultant. Cette valeur ne peut pas être null.

index
Int32

Décalage dans la mémoire tampon où commencer à copier le résultat.

count
Int32

Nombre maximal d’octets à copier dans la mémoire tampon. Le nombre réel d’octets copiés est retourné à partir de cette méthode.

Retours

Int32

Nombre d’octets écrits dans la mémoire tampon.

Exceptions

ArgumentNullException

La buffer valeur est null.

InvalidOperationException

Le nœud actuel n’est pas un nœud d’élément.

ArgumentOutOfRangeException

L’index dans la mémoire tampon ou l’index + nombre est supérieur à la taille de mémoire tampon allouée.

XmlException

L’élément contient du contenu mixte.

FormatException

Le contenu ne peut pas être converti en type demandé.

Exemples

Consultez XmlReader.ReadElementContentAsBinHex un exemple utilisant cette méthode.

Remarques

Note

Pour tirer parti des fonctionnalités plus récentes, la pratique recommandée consiste à créer XmlReader des instances à l’aide de la XmlReaderSettings classe et de la Create méthode. Pour plus d’informations, consultez la section Remarques dans la XmlReader page de référence.

Cette méthode lit le contenu de l’élément, le décode à l’aide de l’encodage BinHex et retourne les octets binaires décodés (par exemple, une image GIF encodée binHex inline) dans la mémoire tampon.

Cette méthode ne peut lire que des éléments de contenu simple. L’élément peut contenir du texte, un espace blanc, un espace blanc significatif, des sections CDATA, des commentaires et des instructions de traitement. Il peut également contenir des références d’entité, qui sont automatiquement développées. L’élément ne peut pas avoir d’éléments enfants.

Cette méthode est très similaire à la ReadContentAsBinHex méthode, sauf qu’elle ne peut être appelée que sur les types de nœuds d’élément.

Si la valeur de nombre est supérieure au nombre d’octets du document ou si elle est égale au nombre d’octets du document, elle XmlNodeReader lit tous les octets restants dans le document et retourne le nombre d’octets lus. L’appel de méthode suivant XmlNodeReader retourne un zéro et déplace le lecteur vers le nœud suivant le EndElement nœud.

Si vous appelez Read avant que tout le contenu de l’élément soit consommé, le lecteur peut se comporter comme si le premier contenu a été consommé, puis la Read méthode a été appelée. Cela signifie que le lecteur lit tout le texte jusqu’à ce que l’élément final soit rencontré. Il lit ensuite le nœud d’étiquette de fin, lit le nœud suivant, puis se positionne sur le nœud suivant.

S’applique à

Voir aussi