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

Definição

Inicia uma operação de gravação assíncrona.Begins an asynchronous write operation.

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);
[System.Security.SecurityCritical]
public override IAsyncResult BeginWrite (byte[] buffer, int offset, int count, AsyncCallback callback, object state);
override this.BeginWrite : byte[] * int * int * AsyncCallback * obj -> IAsyncResult
[<System.Security.SecurityCritical>]
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.The buffer that contains the data to write to the current stream.

offset
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

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

callback
AsyncCallback

O método a ser chamado quando a operação de gravação assíncrona é concluída.The method to call when the asynchronous write operation is completed.

state
Object

Um objeto fornecido pelo usuário que distingue essa solicitação de gravação assíncrona específica de outras solicitações.A user-provided object that distinguishes this particular asynchronous write request from other requests.

Retornos

IAsyncResult

Um objeto IAsyncResult que faz referência à operação de gravação assíncrona.An IAsyncResult object that references the asynchronous write operation.

Atributos

Exceções

buffer é null.buffer is null.

offset é menor que 0.offset is less than 0.

- ou --or- count é menor que 0.count is less than 0.

count é maior que o número de bytes disponível no buffer.count is greater than the number of bytes available in buffer.

O pipe está fechado.The pipe is closed.

O pipe não dá suporte a operações de gravação.The pipe does not support write operations.

O pipe está desconectado, esperando para conectar-se ou o identificador não foi definido.The pipe is disconnected, waiting to connect, or the handle has not been set.

O pipe está interrompido ou ocorreu outro erro de E/S.The pipe is broken or another I/O error occurred.

Comentários

EndWrite deve ser chamado uma vez para cada chamada para BeginWrite .EndWrite must be called once for every call to BeginWrite. Isso pode ser feito no mesmo código chamado BeginWrite ou em um retorno de chamada que é passado para BeginWrite .This can be done either in the same code that called BeginWrite or in a callback that is passed to BeginWrite.

Use a CanWrite propriedade para determinar se o PipeStream objeto atual oferece suporte a operações de gravação.Use the CanWrite property to determine whether the current PipeStream object supports write operations.

Se o pipe for fechado ou um argumento inválido for passado para BeginWrite , as exceções apropriadas serão geradas imediatamente.If the pipe is closed or an invalid argument is passed to BeginWrite, the appropriate exceptions are raised immediately. Os erros que ocorrem durante uma solicitação de gravação assíncrona ocorrem no thread do pool de threads que está executando a solicitação.Errors that occur during an asynchronous write request occur on the thread pool thread that is performing the request. As exceções são geradas quando o código chama o EndWrite método.The exceptions are raised when the code calls the EndWrite method.

Aplica-se a