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

Definizione

Legge il contenuto e restituisce i 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 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.

L'indice nel buffer o nell'indice + conteggio è maggiore della dimensione del buffer allocata.

Commenti

Note

La XmlValidatingReader classe è obsoleta in .NET Framework 2.0. È possibile creare un'istanza di convalida XmlReader usando la XmlReaderSettings classe e il Create metodo . Per altre informazioni, vedere la sezione Note della pagina di riferimento XmlReader.

Questo metodo trasmette il contenuto, decodifica il contenuto di Base64 e restituisce i byte binari decodificati (ad esempio, un'immagine GIF con codifica Base64 inline) 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 rimanenti nel flusso, il lettore rimane nella posizione corrente.

  • ReadContentAsBase64 non è supportato nei tipi di nodo XML seguenti: Element, XmlDeclaration, None, Document, DocumentType, Notation, Entity e DocumentFragment.

Si applica a

Vedi anche