Stream.WriteByte(Byte) Método

Referência

Definição

Namespace:: System.IO

Assembly:: System.IO.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Assembly:: mscorlib.dll

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.

Grava um byte na posição atual no fluxo e avança a posição dentro no fluxo em um byte.

public:
 virtual void WriteByte(System::Byte value);

public virtual void WriteByte (byte value);

abstract member WriteByte : byte -> unit
override this.WriteByte : byte -> unit

Public Overridable Sub WriteByte (value As Byte)

Parâmetros

value: Byte

O byte a ser gravado no fluxo.

Exceções

IOException

Ocorre um erro de E/S.

NotSupportedException

O fluxo não dá suporte à gravação ou o fluxo já foi fechado.

ObjectDisposedException

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

Comentários

Use a CanWrite propriedade para determinar se a instância atual oferece suporte à gravação.

Notas aos Herdeiros

A implementação padrão em Stream cria uma nova matriz de byte único e, em seguida, chama Write(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 grava no buffer diretamente, evitando a alocação de matriz extra em cada chamada.

Aplica-se a