XmlReader.ReadContentAsBase64(Byte[], Int32, Int32) XmlReader.ReadContentAsBase64(Byte[], Int32, Int32) XmlReader.ReadContentAsBase64(Byte[], Int32, Int32) XmlReader.ReadContentAsBase64(Byte[], Int32, Int32) Method

Definizione

Legge il contenuto e restituisce byte binari decodificati Base64.Reads the content and returns the Base64 decoded binary bytes.

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

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

ReadContentAsBase64(Byte[], Int32, Int32) non è supportato nel nodo corrente.ReadContentAsBase64(Byte[], Int32, Int32) is not supported on the current node.

In alternativa-or-

È stato chiamato un metodo della classe XmlReader prima del completamento di un'operazione asincrona precedente.An XmlReader method was called before a previous asynchronous operation finished. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

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 XmlReader non supporta questo metodo.The XmlReader implementation does not support this method.

Commenti

Streaming del contenuto di questo metodo, decodifica il Base64 del contenuto e restituisce i byte binari decodificati (ad esempio, un inline Base64 immagine GIF codificati) nel buffer.This method streams the content, decodes the Base64 content, and returns the decoded binary bytes (for example, an inline Base64 encoded GIF image) into the buffer. Questo metodo può essere chiamato in successione per leggere i grandi flussi di testo incorporato.This method can be called successively to read large streams of embedded text. Per altre informazioni, vedere RFC 1521, "parte MIME (Multipurpose Internet Mail Extensions) uno: Meccanismi per la specifica e che descrive il 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 richiesta per il sito Web di commenti.You can obtain RFCs from the Request for Comments Web site.

Nota

Non è necessario accedere una delle proprietà tra le chiamate al lettore le ReadContentAsBase64 metodo fino a quando il metodo restituisce il valore 0.You should not access any of the reader properties between calls to the ReadContentAsBase64 method until the method returns the value 0.

Questo metodo presenta il comportamento seguente:This method has the following behavior:

  • ReadContentAsBase64 Restituisce il valore 0 quando ha raggiunto la fine del flusso di byte su cui è stato eseguito.ReadContentAsBase64 returns the value 0 when it has reached the end of the byte stream it was operating on. Il reader è posizionato sul primo nodo non di contenuto.The reader is positioned on the first non-content node.

  • Se si richiede un valore più basso, o il numero esatto di byte rispetto a quelli vengono lasciati nel flusso di cui il lettore resti nella posizione corrente.If you ask for fewer, or the exact number of, bytes than are left in the stream the reader remains in its current position.

  • ReadContentAsBase64 non è supportato nei tipi di nodo XML seguenti: Element, XmlDeclaration, None, Document, DocumentType, Notation, Entity, DocumentFragment.ReadContentAsBase64 is not supported on the following XML node types: Element, XmlDeclaration, None, Document, DocumentType, Notation, Entity, DocumentFragment.

Per la versione asincrona di questo metodo, vedere ReadContentAsBase64Async.For the asynchronous version of this method, see ReadContentAsBase64Async.

Si applica a

Vedi anche