Compartir vía


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

Definición

Comienza una operación de escritura asincrónica.

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[]

Búfer que contiene los datos que se van a escribir en la secuencia actual.

offset
Int32

Desplazamiento de bytes de base cero en el buffer que se comienzan a copiar bytes en la secuencia actual.

count
Int32

Número máximo de bytes que se van a escribir.

callback
AsyncCallback

Método al que se llama cuando se completa la operación de escritura asincrónica.

state
Object

Objeto proporcionado por el usuario que distingue esta solicitud de escritura asincrónica determinada de otras solicitudes.

Devoluciones

Objeto IAsyncResult que hace referencia a la operación de escritura asincrónica.

Atributos

Excepciones

buffer es null.

offset es menor que 0.

O bien

count es menor que 0.

count es mayor que el número de bytes disponibles en buffer.

La tubería está cerrada.

La canalización no admite operaciones de escritura.

La canalización está desconectada, esperando a conectarse o no se ha establecido el identificador.

Se ha roto la canalización u se produjo otro error de E/S.

Comentarios

EndWrite se debe llamar una vez para cada llamada a BeginWrite. Esto se puede hacer en el mismo código que llamó BeginWrite a o en una devolución de llamada que se pasa a BeginWrite.

Use la CanWrite propiedad para determinar si el objeto actual PipeStream admite operaciones de escritura.

Si la canalización está cerrada o se pasa un argumento no válido a BeginWrite, las excepciones adecuadas se generan inmediatamente. Los errores que se producen durante una solicitud de escritura asincrónica se producen en el subproceso del grupo de subprocesos que realiza la solicitud. Las excepciones se generan cuando el código llama al EndWrite método .

Se aplica a