Stream.WriteByte(Byte) Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Origem:

Stream.cs

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 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.

Confira também

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