MemoryStream.Write Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.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>)

Origem:

MemoryStream.cs

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> buffer);

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

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

Public Overrides 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 dessa região para o fluxo de memória atual.

Write(Byte[], Int32, Int32)

Origem:

MemoryStream.cs

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 no 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 permanecerá inalterada.

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

Confira também

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