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

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 et retourne les octets binaires décodés au format BinHex.

public:
 virtual int ReadContentAsBinHex(cli::array <System::Byte> ^ buffer, int index, int count);

public virtual int ReadContentAsBinHex (byte[] buffer, int index, int count);

abstract member ReadContentAsBinHex : byte[] * int * int -> int
override this.ReadContentAsBinHex : byte[] * int * int -> int

Public Overridable 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.

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

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.

NotSupportedException

L'implémentation de XmlReader ne prend pas en charge cette méthode.

Remarques

Cette méthode diffuse le contenu, décode le BinHex contenu et retourne les octets binaires décodés (par exemple, une image GIF encodée en ligne BinHex ) dans la mémoire tampon. Cette méthode peut être appelée successivement pour lire de grands flux de texte incorporé.

Notes

Vous ne devez pas accéder aux propriétés de lecteur entre les appels à la ReadContentAsBinHex méthode tant que la méthode ne retourne pas 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 elle fonctionnait. Le lecteur est positionné sur le premier nœud non contenu.
Si vous demandez moins, ou le nombre exact, d’octets que sont laissés dans le flux, le lecteur reste à sa position actuelle.
ReadContentAsBinHexn’est pas pris en charge sur les types de nœuds XML suivants : Element, XmlDeclaration, Document``None, DocumentType, , Notation, Entity, . DocumentFragment

Pour obtenir la version asynchrone de cette méthode, consultez ReadContentAsBinHexAsync.

S’applique à

Partager via