Stream.Write Método

Definição

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.When overridden in a derived class, writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written.

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.When overridden in a derived class, writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written.

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.When overridden in a derived class, writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written.

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.A region of memory. Esse método copia o conteúdo desta região para o fluxo atual.This method copies the contents of this region to the current stream.

Comentários

Use a CanWrite propriedade para determinar se a instância atual oferece suporte à gravação.Use the CanWrite property to determine whether the current instance supports writing. Use o WriteAsync método para gravar de forma assíncrona no fluxo atual.Use the WriteAsync method to write asynchronously to the current stream.

Se a operação de gravação for bem-sucedida, a posição dentro do fluxo avança pelo número de bytes gravados.If the write operation is successful, the position within the stream advances by the number of bytes written. Se ocorrer uma exceção, a posição dentro do fluxo permanecerá inalterada.If an exception occurs, the position within the stream remains unchanged.

Aplica-se a

Produto Introduzida

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.When overridden in a derived class, writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written.

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.An array of bytes. Esse método copia count bytes do buffer para o fluxo atual.This method copies count bytes from buffer to the current stream.

offset
Int32

O deslocamento de bytes baseado em zero em buffer no qual será iniciada a cópia de bytes no fluxo atual.The zero-based byte offset in buffer at which to begin copying bytes to the current stream.

count
Int32

O número de bytes a serem gravados no fluxo atual.The number of bytes to be written to the current stream.

Exceções

A soma de offset e count é maior que o comprimento do buffer.The sum of offset and count is greater than the buffer length.

buffer é null.buffer is null.

offset ou count é negativo.offset or count is negative.

Ocorreu um erro de E/S, como não ser possível encontrar o arquivo especificado.An I/O error occurred, such as the specified file cannot be found.

Não há suporte para gravação no fluxo.The stream does not support writing.

Write(Byte[], Int32, Int32) foi chamado depois que o fluxo foi fechado.Write(Byte[], Int32, Int32) was called after the stream was closed.

Comentários

Use a CanWrite propriedade para determinar se a instância atual oferece suporte à gravação.Use the CanWrite property to determine whether the current instance supports writing. Use o WriteAsync método para gravar de forma assíncrona no fluxo atual.Use the WriteAsync method to write asynchronously to the current stream.

Se a operação de gravação for bem-sucedida, a posição dentro do fluxo avança pelo número de bytes gravados.If the write operation is successful, the position within the stream advances by the number of bytes written. Se ocorrer uma exceção, a posição dentro do fluxo permanecerá inalterada.If an exception occurs, the position within the stream remains unchanged.

Confira também

Aplica-se a

Produto Introduzida