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

Riferimento

Definizione

Spazio dei nomi:: System.Xml

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Source:: XmlNodeReader.cs

Source:: XmlNodeReader.cs

Source:: XmlNodeReader.cs

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 l'elemento e decodifica il contenuto Base64.

public:
 override int ReadElementContentAsBase64(cli::array <System::Byte> ^ buffer, int index, int count);

public override int ReadElementContentAsBase64 (byte[] buffer, int index, int count);

override this.ReadElementContentAsBase64 : byte[] * int * int -> int

Public Overrides Function ReadElementContentAsBase64 (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

Il nodo corrente non è un nodo elemento.

ArgumentOutOfRangeException

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

XmlException

L'elemento include contenuto misto.

FormatException

Il contenuto non può essere convertito nel tipo richiesto.

Esempio

Vedere XmlReader.ReadElementContentAsBase64 per visualizzare un esempio relativo all'uso di questo metodo.

Commenti

Nota

In .NET Framework 2.0, la procedura consigliata consiste nel creare XmlReader istanze usando la XmlReaderSettings classe e il Create metodo . In questo modo è possibile sfruttare appieno tutte le nuove funzionalità introdotte in .NET Framework. Per altre informazioni, vedere la sezione Osservazioni nella pagina di XmlReader riferimento.

Questo metodo legge il contenuto, lo decodifica usando la codifica Base64 e restituisce i byte binari decodificati (ad esempio, un'immagine GIF con codifica Base64 inline) nel buffer. 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.

Questo metodo può leggere solo elementi di contenuto semplice. L'elemento può contenere testo, spazi vuoti, spazi vuoti significativi, sezioni CDATA, commenti ed istruzioni di elaborazione. Può anche contenere riferimenti a entità, che vengono espansi automaticamente. L'elemento non può contenere elementi figlio.

Questo metodo è molto simile al metodo, ad eccezione del ReadContentAsBase64 fatto che può essere chiamato solo sui tipi di nodo elemento.

Se il valore di conteggio è maggiore del numero di byte nel documento o se è uguale al numero di byte nel documento, XmlNodeReader legge tutti i byte rimanenti nel documento e restituisce il numero di byte letti. La chiamata al metodo successivo ReadElementContentAsBase64 restituisce uno zero e sposta il lettore nel nodo che segue il EndElement nodo.

Se si chiama Read prima che venga utilizzato tutto il contenuto dell'elemento, il lettore può comportarsi come se il primo contenuto fosse utilizzato e quindi il Read metodo è stato chiamato. Ciò significa che il lettore legge tutto il testo fino a quando non viene rilevato l'elemento finale. Legge quindi il nodo del tag finale, legge il nodo successivo e quindi si posiziona sul nodo successivo.

Si applica a