Stream.Write Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Sobrecargas

Write(ReadOnlySpan<Byte>)	Quando for substituído em uma classe derivada, grava uma sequência de bytes no fluxo atual e avança a posição atual dentro desse fluxo até o número de bytes gravados.
Write(Byte[], Int32, Int32)	Quando for substituído em uma classe derivada, grava uma sequência de bytes no fluxo atual e avança a posição atual dentro desse fluxo até o número de bytes gravados.

Write(ReadOnlySpan<Byte>)

Origem:

Stream.cs

Quando for substituído em uma classe derivada, grava uma sequência de bytes no fluxo atual e avança a posição atual dentro desse fluxo até o número de bytes gravados.

public:
 virtual void Write(ReadOnlySpan<System::Byte> buffer);

public virtual void Write (ReadOnlySpan<byte> buffer);

abstract member Write : ReadOnlySpan<byte> -> unit
override this.Write : ReadOnlySpan<byte> -> unit

Public Overridable Sub Write (buffer As ReadOnlySpan(Of Byte))

Parâmetros

buffer

ReadOnlySpan<Byte>

Uma região da memória. Esse método copia o conteúdo desta região para o fluxo atual.

Comentários

Use a CanWrite propriedade para determinar se a instância atual dá suporte à gravação. Use o WriteAsync método para gravar de forma assíncrona no fluxo atual.

Se a operação de gravação for bem-sucedida, a posição dentro do fluxo avançará pelo número de bytes gravados. Se ocorrer uma exceção, a posição dentro do fluxo permanecerá inalterada.

Write(Byte[], Int32, Int32)

Origem:

Stream.cs

Quando for substituído em uma classe derivada, grava uma sequência de bytes no fluxo atual e avança a posição atual dentro desse fluxo até o número de bytes gravados.

public:
 abstract void Write(cli::array <System::Byte> ^ buffer, int offset, int count);

public abstract void Write (byte[] buffer, int offset, int count);

abstract member Write : byte[] * int * int -> unit

Public MustOverride Sub Write (buffer As Byte(), offset As Integer, count As Integer)

Parâmetros

buffer

Byte[]

Uma matriz de bytes. Esse método copia count bytes do buffer para o fluxo atual.

offset

Int32

O deslocamento de bytes baseado em zero em buffer no qual será iniciada a cópia de bytes no fluxo atual.

count

Int32

O número de bytes a serem gravados no fluxo atual.

Exceções

ArgumentException

A soma de offset e count é maior que o comprimento do buffer.

ArgumentNullException

buffer é null.

ArgumentOutOfRangeException

offset ou count é negativo.

IOException

Ocorreu um erro de E/S, como não ser possível encontrar o arquivo especificado.

NotSupportedException

Não há suporte para gravação no fluxo.

ObjectDisposedException

Write(Byte[], Int32, Int32) foi chamado depois que o fluxo foi fechado.

Comentários

Use a CanWrite propriedade para determinar se a instância atual dá suporte à gravação. Use o WriteAsync método para gravar de forma assíncrona no fluxo atual.

Se a operação de gravação for bem-sucedida, a posição dentro do fluxo avançará pelo número de bytes gravados. Se ocorrer uma exceção, a posição dentro do fluxo permanecerá inalterada.

Confira também

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