XmlReader.ReadContentAsBinHex(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 BinHex.

public:
 virtual int ReadContentAsBinHex(cli::array <System::Byte> ^ buffer, int index, int count);
public virtual int ReadContentAsBinHex (byte[] buffer, int index, int count);
abstract member ReadContentAsBinHex : byte[] * int * int -> int
override this.ReadContentAsBinHex : byte[] * int * int -> int
Public Overridable Function ReadContentAsBinHex (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

ReadContentAsBinHex(Byte[], Int32, Int32) non è supportato nel nodo corrente.

-oppure-

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

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.

Commenti

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

Nota

Non è consigliabile accedere ad alcuna proprietà del lettore tra le chiamate al ReadContentAsBinHex metodo fino a quando il metodo non restituisce il valore 0.

Questo metodo ha il comportamento seguente:

  • ReadContentAsBinHex 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.

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

Per la versione asincrona di questo metodo, vedere ReadContentAsBinHexAsync.

Si applica a

Vedi anche