XmlValidatingReader.ReadContentAsBase64(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 Base64.

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

public override int ReadContentAsBase64 (byte[] buffer, int index, int count);

override this.ReadContentAsBase64 : byte[] * int * int -> int

Public Overrides 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 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

ReadContentAsBase64(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

Notes

La XmlValidatingReader classe est obsolète dans .NET Framework 2.0. Vous pouvez créer une instance de validation à XmlReader l’aide de la XmlReaderSettings classe et de la Create méthode. Pour plus d'informations, consultez la section Notes de la page de référence XmlReader.

Cette méthode diffuse le contenu, décode le contenu Base64 et retourne les octets binaires décodés (par exemple, une image GIF encodée en base64 inline) 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.

Notes

Vous ne devez accéder à aucune des propriétés de lecteur entre les appels à la ReadContentAsBase64 méthode tant que la méthode n’a pas retourné 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.
ReadContentAsBase64 n’est pas pris en charge sur les types de nœuds XML suivants : Élément, XmlDeclaration, None, Document, DocumentType, Notation, Entity et DocumentFragment.

S’applique à

Partager via