XmlNodeReader.ReadContentAsBase64(Byte[], Int32, Int32) Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Xml

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Legge il contenuto e restituisce byte binari decodificati 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

Parametri

buffer: Byte[]

Buffer in cui copiare il testo risultante. Questo valore non può essere null.

index: Int32

Offset nel buffer a partire da cui iniziare a copiare il risultato.

count: Int32

Numero massimo di byte da copiare nel buffer. Il numero effettivo di byte copiati viene restituito da questo metodo.

Restituisce

Int32

Numero di byte scritti nel buffer.

Eccezioni

ArgumentNullException

Il valore buffer è null.

InvalidOperationException

ReadContentAsBase64(Byte[], Int32, Int32) non è supportato nel nodo corrente.

ArgumentOutOfRangeException

L'indice nel buffer oppure la somma di indice e numero è superiore alla dimensione del buffer allocato.

Commenti

Nota

Nella .NET Framework 2.0, la procedura consigliata consiste nel creare XmlReader istanze usando la classe e il XmlReaderSettings Create metodo . Ciò consente di sfruttare al meglio tutte le nuove funzionalità introdotte nella .NET Framework. Per altre informazioni, vedere la sezione Osservazioni nella XmlReader pagina di riferimento.

Questo metodo trasmette il contenuto, decodifica il contenuto Base64 e restituisce i byte binari decodificati (ad esempio, un'immagine GIF codificata inline Base64) nel buffer. Questo metodo può essere chiamato successivamente per leggere flussi di testo incorporati di grandi dimensioni. Per altre informazioni, vedere RFC 1521, "MIME (estensioni di posta Internet multiuso) parte 1: meccanismi per specificare e descrivere il formato dei corpi dei messaggi Internet". È possibile ottenere schede di rete dal sito Web Request for Comments .You can get RFCS from the Request for Comments Web site.

Nota

Non è consigliabile accedere alle proprietà del lettore tra chiamate al ReadContentAsBase64 metodo finché il metodo restituisce il valore 0.

Questo metodo ha il comportamento seguente:

ReadContentAsBase64 restituisce il valore 0 quando ha raggiunto la fine del flusso di byte in cui è stato eseguito. Il lettore viene posizionato nel primo nodo non contenuto.
Se si chiede meno o il numero esatto, di byte che non vengono lasciati nel flusso, il lettore rimane nella posizione corrente.
ReadContentAsBase64 non è supportato nei tipi di nodo XML seguenti: Elemento, XmlDeclaration, Nessuno, Document, DocumentType, Notation, Entity, DocumentFragment.

Si applica a