XmlTextReader.ReadContentAsBase64(Byte[], Int32, Int32) Metodo
Definizione
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 i Base64 byte binari decodificati.
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 -> intPublic Overrides Function ReadContentAsBase64 (buffer As Byte(), index As Integer, count As Integer) As IntegerParametri
- buffer
- Byte[]
Buffer in cui copiare il testo risultante. Questo valore non può essere null.
- index
- Int32
Offset nel buffer in 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.
Valori restituiti
Numero di byte scritti nel buffer.
Eccezioni
Il valore buffer è null.
ReadContentAsBase64(Byte[], Int32, Int32) non è supportato nel nodo corrente.
L'indice nel buffer o nell'indice + conteggio è maggiore della dimensione del buffer allocata.
Commenti
Note
È consigliabile creare XmlReader istanze usando il XmlReader.Create metodo per sfruttare le nuove funzionalità.
Questo metodo trasmette il contenuto, decodifica il Base64 contenuto 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 (Multipurpose Internet Mail Extensions) Part One: Mechanisms for Specifying and Describing the Format of Internet Message Bodies". È possibile ottenere RFC dal sito Web Request for Comments .
Note
Non è consigliabile accedere alle proprietà del lettore tra le chiamate al metodo fino a ReadContentAsBase64 quando il metodo non restituisce il valore 0.
Questo metodo ha il comportamento seguente:
ReadContentAsBase64 restituisce il valore 0 quando ha raggiunto la fine del flusso di byte su cui operava. Il lettore è posizionato sul primo nodo non di contenuto.
Se si richiede meno byte o il numero esatto di byte che rimangono nel flusso, il lettore rimane nella posizione corrente.
ReadContentAsBase64non è supportato nei tipi di nodo XML seguenti:
Element,XmlDeclarationNone,Document,DocumentType,Notation,Entity.DocumentFragment
