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

Definizione

Spazio dei nomi:

System.Xml

Assembly:

netstandard.dll, System.Xml.ReaderWriter.dll

Origine:

XmlReader.cs

Legge il contenuto e restituisce i BinHex byte binari decodificati.

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

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 XmlReader metodo prima del completamento di un'operazione asincrona precedente. In questo caso, InvalidOperationException viene generata con il messaggio "Un'operazione asincrona è già in corso".

ArgumentOutOfRangeException

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

NotSupportedException

L'implementazione 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 testo incorporati di grandi dimensioni.

Note

Non è consigliabile accedere ad alcuna proprietà del lettore tra le chiamate al metodo fino a ReadContentAsBinHex 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 di contenuto.

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

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

Per la versione asincrona di questo metodo, vedere ReadContentAsBinHexAsync.

Vedi anche

• ReadElementContentAsBinHex(Byte[], Int32, Int32)
• XmlNodeType