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

Definizione

Legge il contenuto e restituisce i byte binari decodificati BinHex.Reads the content and returns the BinHex decoded binary bytes.

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.The buffer into which to copy the resulting text. Questo valore non può essere null.This value cannot be null.

index
Int32

Offset nel buffer a partire da cui iniziare a copiare il risultato.The offset into the buffer where to start copying the result.

count
Int32

Numero massimo di byte da copiare nel buffer.The maximum number of bytes to copy into the buffer. Il numero effettivo di byte copiati viene restituito da questo metodo.The actual number of bytes copied is returned from this method.

Restituisce

Numero di byte scritti nel buffer.The number of bytes written to the buffer.

Eccezioni

Il valore di buffer è null.The buffer value is null.

ReadContentAsBinHex(Byte[], Int32, Int32) non è supportato nel nodo corrente.ReadContentAsBinHex(Byte[], Int32, Int32) is not supported on the current node.

In alternativa-or-

È stato chiamato un metodo della classe XmlReader prima del completamento di un'operazione asincrona precedente.An XmlReader method was called before a previous asynchronous operation finished. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

L'indice nel buffer oppure la somma di indice e numero è superiore alla dimensione del buffer allocato.The index into the buffer or index + count is larger than the allocated buffer size.

L'implementazione di XmlReader non supporta questo metodo.The XmlReader implementation does not support this method.

Commenti

Questo metodo trasmette il contenuto, decodifica il BinHex contenuto e restituisce i byte binari decodificati (ad esempio, un'immagine GIF codificata in linea BinHex ) nel buffer.This method streams the content, decodes the BinHex content, and returns the decoded binary bytes (for example, an inline BinHex encoded GIF image) into the buffer. Questo metodo può essere chiamato successivamente per leggere flussi di grandi dimensioni di testo incorporato.This method can be called successively to read large streams of embedded text.

Nota

Non è consigliabile accedere a nessuna delle proprietà del lettore tra le chiamate ReadContentAsBinHex al metodo finché il metodo non restituisce 0il valore.You should not access any of the reader properties between calls to the ReadContentAsBinHex method until the method returns the value 0.

Questo metodo presenta il comportamento seguente:This method has the following behavior:

  • ReadContentAsBinHexRestituisce il valore 0 quando ha raggiunto la fine del flusso di byte su cui stava operando.ReadContentAsBinHex returns the value 0 when it has reached the end of the byte stream it was operating on. Il Reader è posizionato sul primo nodo non di contenuto.The reader is positioned on the first non-content node.

  • Se si richiede un numero minore o il numero esatto di byte rispetto a quello lasciato nel flusso, il lettore rimane nella posizione corrente.If you ask for fewer, or the exact number, of bytes than are left in the stream the reader remains in its current position.

  • ReadContentAsBinHexnon è supportato nei tipi di nodo XML seguenti: Element, XmlDeclaration, None, Document, DocumentType, Notation, Entity, DocumentFragment.ReadContentAsBinHex is not supported on the following XML node types: Element, XmlDeclaration, None, Document, DocumentType, Notation, Entity, DocumentFragment.

Per la versione asincrona di questo metodo, vedere ReadContentAsBinHexAsync.For the asynchronous version of this method, see ReadContentAsBinHexAsync.

Si applica a

Vedi anche