PipeStream.BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> IAsyncResultPublic Overrides Function BeginWrite (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResultParámetros
- buffer
- Byte[]
Búfer que contiene los datos que se van a escribir en la secuencia actual.
- offset
- Int32
Desplazamiento en bytes de base cero en buffer desde donde se comienzan a copiar los bytes en la secuencia actual.
- count
- Int32
Número máximo de bytes que se pueden escribir.
- callback
- AsyncCallback
Método al que se va a llamar cuando finalice la escritura asincrónica.
- state
- Object
Objeto proporcionado por el usuario que distingue esta solicitud de escritura asincrónica de otras.
Devoluciones
Objeto IAsyncResult que hace referencia a la operación de escritura asincrónica.
- Atributos
Excepciones
buffer es null.
count es mayor que el número de bytes disponible en buffer.
La canalización está cerrada.
La canalización no admite operaciones de escritura.
La canalización está desconectada, a la espera de conectarse, o bien, no se ha establecido el identificador.
La canalización se ha roto o se ha producido 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.
Utilice 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 producen cuando el código llama al EndWrite método .
