BufferedStream.ReadByte Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Origem:

BufferedStream.cs

Lê um byte do fluxo subjacente e retorna o byte convertido em um int ou retorna -1 se estiver lendo do final do fluxo.

public:
 override int ReadByte();

public override int ReadByte ();

override this.ReadByte : unit -> int

Public Overrides Function ReadByte () As Integer

Retornos

Int32

O byte, convertido em um int ou -1 se estiver lendo do final do fluxo.

Exceções

IOException

Ocorre um erro de E/S, por exemplo, o fluxo ser fechado.

NotSupportedException

Não há suporte para leitura no fluxo.

ObjectDisposedException

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

Notas aos Herdeiros

A implementação padrão em Stream cria uma nova matriz de bytes únicos e, em seguida, chama Read(Byte[], Int32, Int32). Embora isso esteja 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.

Confira também

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