Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo XmlReader.ReadContentAsBinHex (Byte[], Int32, Int32)

 

Legge il contenuto e restituisce i byte binari decodificati BinHex.

Spazio dei nomi:   System.Xml
Assembly:  System.Xml (in System.Xml.dll)

public virtual int ReadContentAsBinHex(
	byte[] buffer,
	int index,
	int count
)

Parametri

buffer

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

index

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

count

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

Valore restituito

Type: System.Int32

Numero di byte scritti nel buffer.

Exception Condition
ArgumentNullException

Il valore buffer è null.

InvalidOperationException

ReadContentAsBinHex non è supportato nel nodo corrente.

ArgumentOutOfRangeException

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

NotSupportedException

L'implementazione di XmlReader non supporta questo metodo.

InvalidOperationException

Un metodo di XmlReader è stato chiamato prima del completamento di un'operazione asincrona precedente.In questo caso, viene generata un'eccezione InvalidOperationException con il messaggio "Un'operazione asincrona è già in corso".

Questo metodo crea un flusso il contenuto, decodifica il BinHex di contenuto e restituisce byte binari decodificati (ad esempio, un inline BinHex immagine GIF con codifica) nel buffer.Questo metodo può essere chiamato successivamente per leggere flussi di grandi dimensioni di testo incorporato.

System_CAPS_noteNota

Non è necessario accedere a proprietà del visualizzatore tra le chiamate alla ReadContentAsBinHex metodo fino a quando il metodo restituisce il valore 0.

Questo metodo presenta il seguente comportamento:

  • ReadContentAsBinHexRestituisce il valore 0 quando ha raggiunto la fine del flusso di byte in cui è stato eseguito.Il lettore è posizionato sul primo nodo non di contenuto.

  • Se si richiede un numero inferiore o il numero esatto di byte sono ancora nel flusso, il lettore resta nella posizione corrente.

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

Per la versione asincrona del metodo, vedere ReadContentAsBinHexAsync.

Universal Windows Platform
Disponibile da 4.5
.NET Framework
Disponibile da 2.0
Portable Class Library
Supportato in: portable .NET platforms
Silverlight
Disponibile da 2.0
Windows Phone Silverlight
Disponibile da 7.0
Windows Phone
Disponibile da 8.1
Torna all'inizio
Mostra: