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.Reads a byte from the stream and advances the position within the stream by one byte, or returns -1 if at the end of the stream.

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 Int32 ou -1 se o final do fluxo for atingido.The unsigned byte cast to an Int32, or -1 if at the end of the stream.

Exceções

Não há suporte para leitura no fluxo.The stream does not support reading.

Foram chamados métodos depois que o fluxo foi fechado.Methods were called after the stream was closed.

Comentários

Use a CanRead propriedade para determinar se a instância atual oferece suporte à leitura.Use the CanRead property to determine whether the current instance supports reading.

As tentativas de manipular o fluxo após o fluxo ser fechado podem gerar um ObjectDisposedException .Attempts to manipulate the stream after the stream has been closed could throw an 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) .The default implementation on Stream creates a new single-byte array and then calls Read(Byte[], Int32, Int32). Embora isso seja formalmente correto, ele é ineficiente.While this is formally correct, it is inefficient. 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.Any stream with an internal buffer should override this method and provide a much more efficient version that reads the buffer directly, avoiding the extra array allocation on every call.

Aplica-se a