XmlReader.ReadContentAsBinHex(Byte[], Int32, Int32) Método

Definição

Lê o conteúdo e retorna os bytes binários decodificados 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

Parâmetros

buffer
Byte[]

O buffer para o qual o texto resultante será copiado.The buffer into which to copy the resulting text. Este valor pode não ser null.This value cannot be null.

index
Int32

O deslocamento do buffer no qual o resultado começará a ser copiado.The offset into the buffer where to start copying the result.

count
Int32

O número máximo de bytes a serem copiados para o buffer.The maximum number of bytes to copy into the buffer. O número real de bytes copiados é retornado deste método.The actual number of bytes copied is returned from this method.

Retornos

Int32

O número de bytes gravados no buffer.The number of bytes written to the buffer.

Exceções

O valor buffer é null.The buffer value is null.

Não há suporte para ReadContentAsBinHex(Byte[], Int32, Int32) no nó atual.ReadContentAsBinHex(Byte[], Int32, Int32) is not supported on the current node.

- ou --or-

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior.An XmlReader method was called before a previous asynchronous operation finished. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

O índice de buffer ou de índice + contagem é maior que o tamanho do buffer alocado.The index into the buffer or index + count is larger than the allocated buffer size.

A implementação XmlReader não dá suporte a esse método.The XmlReader implementation does not support this method.

Comentários

Esse método transmite o conteúdo, decodifica o BinHex conteúdo e retorna os bytes binários decodificados (por exemplo, uma BinHex imagem GIF codificada embutida) para o 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. Esse método pode ser chamado sucessivamente para ler grandes fluxos de texto inseridos.This method can be called successively to read large streams of embedded text.

Observação

Você não deve acessar nenhuma das propriedades do leitor entre as chamadas para o ReadContentAsBinHex método até que o método retorne o valor 0 .You should not access any of the reader properties between calls to the ReadContentAsBinHex method until the method returns the value 0.

Esse método tem o seguinte comportamento:This method has the following behavior:

  • ReadContentAsBinHex Retorna o valor 0 quando ele atingiu o final do fluxo de bytes em que estava operando.ReadContentAsBinHex returns the value 0 when it has reached the end of the byte stream it was operating on. O leitor está posicionado no primeiro nó que não é de conteúdo.The reader is positioned on the first non-content node.

  • Se você solicitar menos, ou o número exato de bytes do que o restante no fluxo, o leitor permanecerá em sua posição atual.If you ask for fewer, or the exact number, of bytes than are left in the stream the reader remains in its current position.

  • ReadContentAsBinHex Não tem suporte nos seguintes tipos de nó XML:,,,,, 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.

Para obter a versão assíncrona desse método, consulte ReadContentAsBinHexAsync .For the asynchronous version of this method, see ReadContentAsBinHexAsync.

Aplica-se a

Confira também