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

Referência

Definição

Namespace:: System.Xml

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

Parâmetros

buffer: Byte[]

O buffer para o qual o texto resultante será copiado. Este valor pode não ser null.

index: Int32

O deslocamento do buffer no qual o resultado começará a ser copiado.

count: Int32

O número máximo de bytes a serem copiados para o buffer. O número real de bytes copiados é retornado deste método.

Retornos

Int32

O número de bytes gravados no buffer.

Exceções

ArgumentNullException

O valor buffer é null.

InvalidOperationException

Não há suporte para ReadContentAsBinHex(Byte[], Int32, Int32) no nó atual.

- ou -

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

ArgumentOutOfRangeException

O índice de buffer ou de índice + contagem é maior que o tamanho do buffer alocado.

NotSupportedException

A implementação XmlReader não dá suporte a esse método.

Comentários

Esse método transmite o conteúdo, decodifica o BinHex conteúdo e retorna os bytes binários decodificados (por exemplo, uma imagem GIF codificada embutida BinHex ) no buffer. Esse método pode ser chamado sucessivamente para ler grandes fluxos de texto inserido.

Nota

Você não deve acessar nenhuma das propriedades do leitor entre chamadas ao método até que ReadContentAsBinHex o método retorne o valor 0.

Esse método tem o seguinte comportamento:

ReadContentAsBinHex retorna o valor 0 quando ele chegou ao final do fluxo de bytes em que estava operando. O leitor está posicionado no primeiro nó sem conteúdo.
Se você pedir menos, ou o número exato, de bytes do que o restante no fluxo, o leitor permanecerá em sua posição atual.
ReadContentAsBinHexnão há suporte nos seguintes tipos de nó XML: Element, , XmlDeclaration, None, , Document, DocumentType, , Notation, Entity. DocumentFragment

Para obter a versão assíncrona deste método, consulte ReadContentAsBinHexAsync.

Aplica-se a

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Partilhar via