MemoryStream.Write Método

Definição

Namespace:
System.IO
Assembly:
netstandard.dll
Assemblies:
mscorlib.dll, System.IO.dll
Assembly:
mscorlib.dll
Assembly:
System.IO.dll

Sobrecargas

Nome Description
Write(ReadOnlySpan<Byte>)

Grava a sequência de bytes contidos no source fluxo de memória atual e avança a posição atual dentro desse fluxo de memória pelo número de bytes gravados.
Write(Byte[], Int32, Int32)

Grava um bloco de bytes no fluxo atual usando dados lidos de um buffer.

Write(ReadOnlySpan<Byte>)

Grava a sequência de bytes contidos no source fluxo de memória atual e avança a posição atual dentro desse fluxo de memória pelo número de bytes gravados.

public:
 override void Write(ReadOnlySpan<System::Byte> source);
public override void Write(ReadOnlySpan<byte> source);
override this.Write : ReadOnlySpan<byte> -> unit
Public Overrides Sub Write (source As ReadOnlySpan(Of Byte))

Parâmetros

sourcebuffer
ReadOnlySpan<Byte>

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

Aplica-se a

Write(Byte[], Int32, Int32)

Grava um bloco de bytes no fluxo atual usando dados lidos de um buffer.

public:
 override void Write(cli::array <System::Byte> ^ buffer, int offset, int count);
public override void Write(byte[] buffer, int offset, int count);
override this.Write : byte[] * int * int -> unit
Public Overrides Sub Write (buffer As Byte(), offset As Integer, count As Integer)

Parâmetros

buffer
Byte[]

O buffer do qual gravar dados.

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 máximo de bytes a serem gravados.

Exceções

ArgumentNullException

buffer é null.

NotSupportedException

O fluxo não dá suporte à gravação. Para obter informações adicionais, consulte CanWrite.

-ou-

A posição atual está mais próxima do que count os bytes ao final do fluxo e a capacidade não pode ser modificada.

ArgumentException

offset subtraído do comprimento do buffer é menor que count.

ArgumentOutOfRangeException

offset ou count são negativos.

IOException

Ocorre um erro de E/S.

ObjectDisposedException

A instância de fluxo atual está fechada.

Exemplos

Este exemplo de código faz parte de um exemplo maior fornecido para a MemoryStream classe.

// Write the first string to the stream.
memStream.Write(firstString, 0 , firstString.Length);

' Write the first string to the stream.
memStream.Write(firstString, 0 , firstString.Length)

Comentários

Este método substitui Write.

O offset parâmetro fornece o deslocamento do primeiro byte buffer no qual gravar e o count parâmetro fornece o número de bytes a serem gravados. Se a operação de gravação for bem-sucedida, a posição atual dentro do fluxo será avançada pelo número de bytes gravados. Se ocorrer uma exceção, a posição atual dentro do fluxo ficará inalterada.

Com exceção de um MemoryStream parâmetro construído com um byte[], as operações de gravação no final de uma MemoryStream expansão do MemoryStream.

Confira também

Aplica-se a