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 -> intPublic Overridable Function ReadByte () As IntegerRetornos
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 oferece suporte à leitura.
As tentativas de manipular o fluxo após o fluxo ser fechado podem gerar um ObjectDisposedException .
Notas aos Herdeiros
A implementação padrão em Stream cria uma nova matriz de byte único e, em seguida, chama Read(Byte[], Int32, Int32) . Embora isso seja formalmente correto, ele é 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.