Partilhar via


Stream.ReadByte Método

Definição

Lê um byte do fluxo e avança a posição no fluxo em um byte ou retorna -1 caso esteja no final do fluxo.

public:
 virtual int ReadByte();
public virtual int ReadByte ();
abstract member ReadByte : unit -> int
override this.ReadByte : unit -> int
Public Overridable Function ReadByte () As Integer

Retornos

O byte sem sinal convertido em um Int32 ou -1 se o final do fluxo for atingido.

Exceções

Não há suporte para leitura no fluxo.

Foram chamados métodos depois que o fluxo foi fechado.

Comentários

Use a CanRead propriedade para determinar se a instância atual dá suporte à leitura.

As tentativas de manipular o fluxo depois que o fluxo tiver sido fechado podem gerar um ObjectDisposedException.

Notas aos Herdeiros

A implementação padrão em Stream cria uma nova matriz de byte único e chama Read(Byte[], Int32, Int32). Embora isso esteja formalmente correto, é ineficiente. Qualquer fluxo com um buffer interno deve substituir esse método e fornecer uma versão muito mais eficiente que lê o buffer diretamente, evitando a alocação de matriz extra em cada chamada.

Aplica-se a

Confira também