XmlNodeReader.ReadElementContentAsBase64(Byte[], Int32, Int32) Méthode
Définition
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 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 -> intPublic Overrides Function ReadElementContentAsBase64 (buffer As Byte(), index As Integer, count As Integer) As IntegerParamè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
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'élément contient le contenu mixte.
Impossible de convertir le contenu en type demandé.
Exemples
Consultez XmlReader.ReadElementContentAsBase64 pour voir un exemple utilisant cette méthode.
Remarques
Notes
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 lit le contenu, 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 Base64 inline) dans la mémoire tampon. Pour plus d’informations, consultez RFC 1521, « MIME (Multipurpose Internet Mail Extensions) Part 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 ne peut lire que les éléments de contenu simple. L’élément peut contenir du texte, des espaces blancs, des espaces blancs significatifs, 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 ne peut être appelée que sur les types de nœuds d’élément.
Si la valeur du nombre est supérieure au nombre d’octets dans le document, ou si elle est égale au nombre d’octets dans le document, le XmlNodeReader lit tous les octets restants dans le document et retourne le nombre d’octets lus. L’appel de méthode suivant ReadElementContentAsBase64 retourne un zéro et déplace le lecteur vers le nœud qui suit le EndElement nœud.
Si vous appelez Read avant que tout le contenu de l’élément ne 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 de fin 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.
