MemoryStream.Write MemoryStream.Write MemoryStream.Write MemoryStream.Write Method

Definição

Sobrecargas

Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>)
Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32)

Grava um bloco de bytes no fluxo atual usando os dados lidos de um buffer.Writes a block of bytes to the current stream using data read from a buffer.

Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>)

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

source
ReadOnlySpan<Byte>

Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32)

Grava um bloco de bytes no fluxo atual usando os dados lidos de um buffer.Writes a block of bytes to the current stream using data read from a 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.The buffer to write data from.

offset
Int32 Int32 Int32 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 Int32 Int32 Int32

O número máximo de bytes a serem gravados.The maximum number of bytes to write.

Exceções

Não há suporte para gravação no fluxo.The stream does not support writing. Para obter mais informações, consulte CanWrite.For additional information see CanWrite.

- ou --or- 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.The current position is closer than count bytes to the end of the stream, and the capacity cannot be modified.

O offset subtraído do tamanho do buffer é menor que count.offset subtracted from the buffer length is less than count.

Ocorre um erro de E/S.An I/O error occurs.

A instância atual do fluxo está fechada.The current stream instance is closed.

Exemplos

Este exemplo de código faz parte de um exemplo maior fornecido para MemoryStream a classe.This code example is part of a larger example provided for the MemoryStream class.

// 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.This method overrides Write.

O offset parâmetro fornece o deslocamento do primeiro byte em buffer para gravação e o count parâmetro fornece o número de bytes a serem gravados.The offset parameter gives the offset of the first byte in buffer to write from, and the count parameter gives the number of bytes to write. 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.If the write operation is successful, the current position within the stream is advanced by the number of bytes written. Se ocorrer uma exceção, a posição atual dentro do fluxo será inalterada.If an exception occurs, the current position within the stream is unchanged.

Exceto por um MemoryStream construído com um parâmetro byte [], as operações de gravação no final de MemoryStream um expandem o MemoryStream.Except for a MemoryStream constructed with a byte[] parameter, write operations at the end of a MemoryStream expand the MemoryStream.

Veja também

Aplica-se a