Condividi tramite

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

  • Riferimento

Definizione

Spazio dei nomi:
System.Xml
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

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

A partire da .NET Framework 2.0, è 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 con codifica inline Base64) nel buffer. Questo metodo può essere chiamato successivamente per leggere flussi di grandi dimensioni di testo incorporato. Per altre informazioni, vedere RFC 1521, "MIME (Multipurpose Internet Mail Extensions) Part One: Meccanismi per specificare e descrivere il formato dei corpi dei messaggi Internet". È possibile ottenere RFC 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 le chiamate al ReadContentAsBase64 metodo finché 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 simmetrico.

  • Se si richiede meno byte o il numero esatto di byte rimanenti nel flusso, il lettore rimane nella posizione corrente.

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

Si applica a

Vedi anche