Partager via


XmlValidatingReader.ReadElementContentAsBase64(Byte[], Int32, Int32) Méthode

Définition

Lit l'élément et décode le contenu Base64.

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

buffer a la valeur null.

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

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.

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

L'élément contient un contenu mixte.

Impossible de convertir le contenu en type demandé.

Remarques

Notes

La XmlValidatingReader classe est obsolète dans .NET Framework 2.0. Vous pouvez créer une instance de validation à l’aide de XmlReader 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 lit le contenu de l’élément, le décode à l’aide de l’encodage Base64 et retourne les octets binaires décodés (par exemple, une image GIF encodée en ligne base64) dans la mémoire tampon. Pour plus d’informations, consultez RFC 1521, « MIME (Extensions de messagerie Internet multiutilisables) 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 demande de commentaires.

Cette méthode peut lire uniquement les éléments de contenu simple. L’élément peut contenir du texte, de l’espace blanc, de l’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 ReadContentAsBase64 méthode, sauf qu’elle peut être appelée uniquement sur les types de nœuds d’élément.

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

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 de balise de fin, lit le nœud suivant, puis se positionne sur le nœud suivant.

S’applique à

Voir aussi