Stream.ReadByte Método
Definição
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ê 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.