BufferedStream.BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) Método

  • Referência

Definição

Namespace:
System.IO
Assembly:
System.Runtime.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Origem:
BufferedStream.cs
Origem:
BufferedStream.cs
Origem:
BufferedStream.cs

Inicia uma operação de gravação assíncrona. (Considere o uso de WriteAsync(Byte[], Int32, Int32, CancellationToken) em seu lugar.)

public:
 override IAsyncResult ^ BeginWrite(cli::array <System::Byte> ^ buffer, int offset, int count, AsyncCallback ^ callback, System::Object ^ state);
public override IAsyncResult BeginWrite (byte[] buffer, int offset, int count, AsyncCallback? callback, object? state);
public override IAsyncResult BeginWrite (byte[] buffer, int offset, int count, AsyncCallback callback, object state);
public override IAsyncResult BeginWrite (byte[] buffer, int offset, int count, AsyncCallback callback, object? state);
override this.BeginWrite : byte[] * int * int * AsyncCallback * obj -> IAsyncResult
Public Overrides Function BeginWrite (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResult

Parâmetros

buffer
Byte[]

O buffer que contém dados a serem gravados no fluxo atual.

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.

callback
AsyncCallback

O método a ser chamado quando a operação de gravação assíncrona for concluída.

state
Object

Um objeto fornecido pelo usuário que distingue essa solicitação de gravação assíncrona específica de outras solicitações.

Retornos

IAsyncResult

Um objeto que faz referência à gravação assíncrona, que ainda pode estar pendente.

Exceções

ArgumentException

O tamanho de buffer menos offset é menor que count.

ArgumentNullException

buffer é null.

ArgumentOutOfRangeException

offset ou count é negativo.

NotSupportedException

Não há suporte para gravação no fluxo.

Comentários

No .NET Framework 4 e versões anteriores, você precisa usar métodos como BeginWrite e EndWrite para implementar operações de arquivo assíncronas. Esses métodos ainda estão disponíveis no .NET Framework 4.5 para dar suporte ao código herdado; no entanto, os novos métodos assíncronos, como ReadAsync, WriteAsynce FlushAsync, ajudam você a implementar operações de arquivo assíncronas com mais facilidade.

EndWrite deve ser chamado exatamente uma vez em cada IAsyncResult de BeginWrite. EndWrite bloqueará até que a operação de E/S seja concluída.

Aplica-se a