Compartilhar via


Stream.WriteByte(Byte) Método

Definição

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

Ocorre um erro de E/S.

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

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

Comentários

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

Notas aos Herdeiros

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

Aplica-se a

Confira também