XmlReader.ReadContentAsBase64(Byte[], Int32, Int32) Méthode

Définition

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

Lit le contenu et retourne les octets binaires décodés en Base64.

public:
 virtual int ReadContentAsBase64(cli::array <System::Byte> ^ buffer, int index, int count);
public virtual int ReadContentAsBase64(byte[] buffer, int index, int count);
abstract member ReadContentAsBase64 : byte[] * int * int -> int
override this.ReadContentAsBase64 : byte[] * int * int -> int
Public Overridable Function ReadContentAsBase64 (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

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

-ou-

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

ArgumentOutOfRangeException

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

NotSupportedException

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

Remarques

Cette méthode diffuse le contenu, décode le Base64 contenu et retourne les octets binaires décodés (par exemple, une image GIF encodée en ligne Base64 ) dans la mémoire tampon. Cette méthode peut être appelée successivement pour lire de grands flux de texte incorporé. Pour plus d’informations, consultez RFC 1521, « MIME (extensions de messagerie Internet multi-usage) Partie 1 : Mécanismes de spécification et de description du format des corps de messages Internet ». Vous pouvez obtenir des RFC à partir du site web Request for Comments.

Note

Vous ne devez accéder à aucune des propriétés de lecteur entre les appels à la ReadContentAsBase64 méthode tant que la méthode ne renvoie pas la valeur 0.

Cette méthode a le comportement suivant :

  • ReadContentAsBase64 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 d’octets, ou le nombre exact d’octets restants dans le flux, le lecteur reste à sa position actuelle.

  • ReadContentAsBase64n’est pas pris en charge sur les types de nœuds XML suivants : Element, , XmlDeclarationDocumentNone, DocumentType, Notation, , . DocumentFragmentEntity

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

S’applique à

Voir aussi