MemoryStream.Write Método

  • Referência

Definição

Namespace:
System.IO
Assembly:
System.Runtime.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
netstandard.dll
Assembly:
System.IO.dll
Assembly:
mscorlib.dll

Sobrecargas

Write(ReadOnlySpan<Byte>)

Grava a sequência de bytes contida em source no fluxo de memória atual e avança a posição atual nesse fluxo de memória até o número de bytes gravados.
Write(Byte[], Int32, Int32)

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

Write(ReadOnlySpan<Byte>)

Grava a sequência de bytes contida em source no fluxo de memória atual e avança a posição atual nesse fluxo de memória até o número de bytes gravados.

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

Parâmetros

sourcebuffer
ReadOnlySpan<Byte>

Uma região da 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 os 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 os dados serão gravados.

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

Exceções

ArgumentNullException

buffer é null.

NotSupportedException

Não há suporte para gravação no fluxo. Para obter mais informações, consulte CanWrite.

- ou - A posição atual está mais próxima do que bytes count até o final do fluxo, e a capacidade não pode ser modificada.

ArgumentException

O offset subtraído do tamanho do buffer é menor que count.

ArgumentOutOfRangeException

offset ou count é negativo.

IOException

Ocorre um erro de E/S.

ObjectDisposedException

A instância atual do fluxo 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);

' 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 do 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 será 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