Partager via

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

  • Référence

Définition

Espace de noms:
System.Xml
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll
Source:
XmlNodeReader.cs
Source:
XmlNodeReader.cs
Source:
XmlNodeReader.cs

Lit le contenu et retourne les octets binaires décodés au format BinHex.

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

Paramètres

buffer
Byte[]

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

index
Int32

Offset de la mémoire tampon où commence la copie du 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

buffer a la valeur null.

InvalidOperationException

ReadContentAsBinHex(Byte[], Int32, Int32) n'est pas pris en charge sur le nœud actuel.

ArgumentOutOfRangeException

L'index de la mémoire tampon (ou l'index augmenté de la valeur du paramètre count) est supérieur à la taille de la mémoire tampon allouée.

Remarques

Remarque

Dans .NET Framework 2.0, la pratique recommandée consiste à créer XmlReader des instances à l’aide de la XmlReaderSettings classe et de la Create méthode . Cela vous permet de tirer pleinement parti de toutes les nouvelles fonctionnalités introduites dans le .NET Framework. Pour plus d’informations, consultez la section Remarques dans la page de XmlReader référence.

Cette méthode diffuse le contenu, décode le contenu 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 peut être appelée successivement pour lire de grands flux de texte incorporé.

Remarque

Vous ne devez accéder à aucune des propriétés de lecteur entre les appels à la ReadContentAsBinHex méthode tant que la méthode n’a pas retourné la valeur 0.

Cette méthode a le comportement suivant :

  • ReadContentAsBinHex retourne la valeur 0 lorsqu’elle a atteint la fin du flux d’octets sur lequel il fonctionnait. Le lecteur est positionné sur le premier nœud hors contenu.

  • Si vous demandez moins d’octets ou le nombre exact d’octets restants dans le flux, le lecteur reste dans sa position actuelle.

  • ReadContentAsBinHex n’est pas pris en charge sur les types de nœuds XML suivants : Element, XmlDeclaration, None, Document, DocumentType, Notation, Entity, DocumentFragment.

S’applique à

Voir aussi