XmlTextReader.ReadElementContentAsBase64(Byte[], Int32, Int32) Metodo

Definizione

Legge l'elemento e decodifica il contenuto Base64.Reads the element and decodes the Base64 content.

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

Parametri

buffer
Byte[]

Buffer in cui copiare il testo risultante.The buffer into which to copy the resulting text. Questo valore non può essere null.This value cannot be null.

index
Int32

Offset nel buffer a partire da cui iniziare a copiare il risultato.The offset into the buffer where to start copying the result.

count
Int32

Numero massimo di byte da copiare nel buffer.The maximum number of bytes to copy into the buffer. Il numero effettivo di byte copiati viene restituito da questo metodo.The actual number of bytes copied is returned from this method.

Restituisce

Numero di byte scritti nel buffer.The number of bytes written to the buffer.

Eccezioni

Il valore di buffer è null.The buffer value is null.

Il nodo corrente non è un nodo elemento.The current node is not an element node.

L'indice nel buffer oppure la somma di indice e numero è superiore alla dimensione del buffer allocato.The index into the buffer or index + count is larger than the allocated buffer size.

L'implementazione di XmlTextReader non supporta questo metodo.The XmlTextReader implementation does not support this method.

L'elemento include contenuto misto.The element contains mixed-content.

Il contenuto non può essere convertito nel tipo richiesto.The content cannot be converted to the requested type.

Esempi

Vedere XmlReader.ReadElementContentAsBase64 per vedere un esempio di utilizzo di questo metodo.See XmlReader.ReadElementContentAsBase64 to see an example using this method.

Commenti

Nota

A partire dalla .NET Framework 2,0, è consigliabile creare istanze di XmlReader usando il metodo XmlReader.Create per sfruttare le nuove funzionalità.Starting with the .NET Framework 2.0, we recommend that you create XmlReader instances by using the XmlReader.Create method to take advantage of new functionality.

Questo metodo legge il contenuto dell'elemento, lo decodifica usando la codifica Base64 e restituisce i byte binari decodificati (ad esempio, un'immagine GIF con codifica Base64 in linea) nel buffer.This method reads the element content, decodes it using Base64 encoding, and returns the decoded binary bytes (for example, an inline Base64 encoded GIF image) into the buffer. Per ulteriori informazioni, vedere RFC 1521, "MIME (Multipurpose Internet Mail Extensions) parte 1: meccanismi per la specifica e la descrizione del formato dei corpi dei messaggi Internet".For more information, see RFC 1521, "MIME (Multipurpose Internet Mail Extensions) Part One: Mechanisms for Specifying and Describing the Format of Internet Message Bodies". È possibile ottenere RFC dal sito Web della richiesta di commenti.You can obtain RFCs from the Request for Comments Web site.

Questo metodo può leggere solo elementi di contenuto semplice.This method can only read simple-content elements. L'elemento può contenere testo, spazi vuoti, spazi vuoti significativi, sezioni CDATA, commenti e istruzioni di elaborazione.The element can contain text, white space, significant white space, CDATA sections, comments and processing instructions. Può inoltre contenere riferimenti a entità, che vengono espansi automaticamente.It can also contain entity references, which are automatically expanded. L'elemento non può avere elementi figlio.The element cannot have child elements.

Questo metodo è molto simile al metodo ReadContentAsBase64 ad eccezione del fatto che può essere chiamato solo sui tipi di nodo dell'elemento.This method is very similar to the ReadContentAsBase64 method except that it can only be called on element node types.

Se il valore count è maggiore del numero di byte nel documento o se è uguale al numero di byte nel documento, il XmlTextReader legge tutti i byte rimanenti nel documento e restituisce il numero di byte letti.If the count value is higher than the number of bytes in the document, or if it is equal to the number of bytes in the document, the XmlTextReader reads all the remaining bytes in the document and returns the number of bytes read. La successiva chiamata al metodo XmlTextReader restituisce zero e sposta il Reader sul nodo dopo l'EndElement.The next XmlTextReader method call returns a zero and moves the reader to the node following the EndElement.

Se si chiama Read prima che tutto il contenuto dell'elemento venga utilizzato, il lettore può comportarsi come se venisse utilizzato il primo contenuto e quindi venisse chiamato il metodo di Read.If you call Read before all of the element content is consumed, the reader may behave as if the first content was consumed and then the Read method was called. Ciò significa che il lettore legge tutto il testo fino a quando non viene rilevato l'elemento finale.This means that the reader reads all the text until the end element is encountered. Legge quindi il nodo tag di fine, legge il nodo successivo e quindi si posiziona nel successivo nodo successivo.It then reads the end tag node, reads the next node, and then positions itself on the next subsequent node.

Si applica a

Vedi anche