Stream.WriteByte(Byte) Método

Definição

Escreve um byte na posição atual no fluxo e avança a posição dentro do 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 para escrever no fluxo.

Exceções

Ocorre um erro de E/S.

O fluxo não suporta escrita, ou o fluxo já está encerrado.

Os métodos foram chamados após o encerramento do riacho.

Observações

Use a CanWrite propriedade para determinar se a instância atual suporta escrita.

Notas para Herdeiros

A implementação padrão em Stream cria um novo array de um byte e depois chama Write(Byte[], Int32, Int32). Embora isto seja formalmente correto, é ineficiente. Qualquer fluxo com buffer interno deve sobrepor este método e fornecer uma versão muito mais eficiente que escreva diretamente no buffer, evitando a alocação extra de array em cada chamada.

Aplica-se a

Ver também