Stream.ReadByte Método

Definição

Namespace:

System.IO

Assemblies:

netstandard.dll, System.Runtime.dll

Origem:

Stream.cs

Lê um byte do fluxo e avança a posição dentro do fluxo por um byte ou retorna -1 se estiver 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

Int32

O byte sem sinal convertido em um Int32ou -1 se estiver no final do fluxo.

Exceções

NotSupportedException

O fluxo não dá suporte à leitura.

ObjectDisposedException

Os métodos foram chamados depois que o fluxo foi fechado.

Comentários

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

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

Notas aos Herdeiros

A implementação padrão cria uma nova matriz de bytes únicos e, em Stream seguida, 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.

Confira também

• E/S de arquivo e de fluxo
• Como ler texto de um arquivo
• Como gravar texto em um arquivo