MemoryStream.Write Método

Definição

Espaço de Nomes:
System.IO
Assemblagens:
netstandard.dll, System.Runtime.dll
Assemblagem:
System.Runtime.Extensions.dll
Assemblagem:
netstandard.dll
Assemblagens:
mscorlib.dll, System.IO.dll
Assemblagem:
System.IO.dll
Assemblagem:
mscorlib.dll

Sobrecargas

Name Description
Write(ReadOnlySpan<Byte>)

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

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

Write(ReadOnlySpan<Byte>)

Origem:
MemoryStream.cs
Origem:
MemoryStream.cs
Origem:
MemoryStream.cs
Origem:
MemoryStream.cs
Origem:
MemoryStream.cs

Escreve a sequência de bytes contida em source no fluxo de memória atual e avança a posição atual dentro desse fluxo de memória pelo número de bytes escritos.

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

Parâmetros

sourcebuffer
ReadOnlySpan<Byte>

Uma região da memória. Este método copia o conteúdo desta região para o fluxo de memória atual.

Aplica-se a

Write(Byte[], Int32, Int32)

Origem:
MemoryStream.cs
Origem:
MemoryStream.cs
Origem:
MemoryStream.cs
Origem:
MemoryStream.cs
Origem:
MemoryStream.cs

Escreve 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 para escrever dados.

offset
Int32

O deslocamento de bytes baseado em zero em buffer que se deve começar a copiar bytes para o fluxo atual.

count
Int32

O número máximo de bytes a escrever.

Exceções

ArgumentNullException

buffer é null.

NotSupportedException

O stream não suporta escrita. Para obter informações adicionais, consulte CanWrite.

-ou-

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

ArgumentException

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

ArgumentOutOfRangeException

offset ou count são negativos.

IOException

Ocorre um erro de E/S.

ObjectDisposedException

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

Observações

Este método substitui o Write.

O offset parâmetro dá o deslocamento do primeiro byte de entrada buffer para escrever, e o count parâmetro indica o número de bytes a escrever. Se a operação de escrita for bem-sucedida, a posição atual dentro do fluxo é avançada pelo número de bytes escritos. Se ocorrer uma exceção, a posição atual dentro do fluxo mantém-se inalterada.

Exceto para um MemoryStream construído com um parâmetro de byte[], as operações de escrita no final de um MemoryStream expandem o MemoryStream.

Ver também

Aplica-se a