Compartilhar via


Stream.Write Método

Definição

Sobrecargas

Nome Description
Write(ReadOnlySpan<Byte>)

Quando 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 pelo número de bytes gravados.

Write(Byte[], Int32, Int32)

Quando 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 pelo número de bytes gravados.

Write(ReadOnlySpan<Byte>)

Origem:
Stream.cs
Origem:
Stream.cs
Origem:
Stream.cs
Origem:
Stream.cs
Origem:
Stream.cs

Quando 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 pelo 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 de memória. Esse método copia o conteúdo dessa 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.

Aplica-se a

Write(Byte[], Int32, Int32)

Origem:
Stream.cs
Origem:
Stream.cs
Origem:
Stream.cs
Origem:
Stream.cs
Origem:
Stream.cs

Quando 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 pelo 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 fluxo atual.

offset
Int32

O deslocamento de bytes baseado em zero no buffer qual começar a copiar bytes para o fluxo atual.

count
Int32

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

Exceções

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

buffer é null.

offset ou count é negativo.

Não foi possível encontrar um erro de E/S, como o arquivo especificado.

O fluxo não dá suporte à gravação.

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

Aplica-se a