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

Definición

Comienza una operación de escritura asincrónica.Begins an asynchronous write operation. (Considere usar WriteAsync(Byte[], Int32, Int32) en su lugar).(Consider using WriteAsync(Byte[], Int32, Int32) instead.)

public:
 virtual IAsyncResult ^ BeginWrite(cli::array <System::Byte> ^ buffer, int offset, int count, AsyncCallback ^ callback, System::Object ^ state);
public virtual IAsyncResult BeginWrite (byte[] buffer, int offset, int count, AsyncCallback callback, object state);
abstract member BeginWrite : byte[] * int * int * AsyncCallback * obj -> IAsyncResult
override this.BeginWrite : byte[] * int * int * AsyncCallback * obj -> IAsyncResult
Public Overridable 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 del que se van a escribir datos.The buffer to write data from.

offset
Int32

Desplazamiento de bytes en buffer donde debe comenzar la escritura.The byte offset in buffer from which to begin writing.

count
Int32

Número máximo de bytes que se pueden escribir.The maximum number of bytes to write.

callback
AsyncCallback

Devolución de llamada asincrónica opcional, a la que se llamará cuando haya finalizado la escritura.An optional asynchronous callback, to be called when the write is complete.

state
Object

Objeto proporcionado por el usuario que distingue esta solicitud de escritura asincrónica de otras.A user-provided object that distinguishes this particular asynchronous write request from other requests.

Devoluciones

IAsyncResult que representa la escritura asincrónica, que puede hallarse aún pendiente.An IAsyncResult that represents the asynchronous write, which could still be pending.

Excepciones

Se ha intentado realizar una escritura asincrónica más allá del final de la secuencia o se ha producido un error de disco.Attempted an asynchronous write past the end of the stream, or a disk error occurs.

Uno o varios argumentos no son válidos.One or more of the arguments is invalid.

Se efectuó una llamada a los métodos después de cerrar la secuencia.Methods were called after the stream was closed.

La implementación actual de Stream no admite la operación de escritura.The current Stream implementation does not support the write operation.

Comentarios

En .NET Framework 4 y versiones anteriores, es necesario usar métodos como BeginWrite y EndWrite para implementar operaciones de E/S asincrónicas.In the .NET Framework 4 and earlier versions, you have to use methods such as BeginWrite and EndWrite to implement asynchronous I/O operations. Estos métodos siguen .NET Framework 4.5.NET Framework 4.5 estando disponibles en para admitir código heredado; sin embargo, los nuevos métodos asincrónicos, ReadAsynccomo, CopyToAsync WriteAsync, y FlushAsync, ayudan a implementar operaciones de e/s asincrónicas más fácilmente.These methods are still available in the .NET Framework 4.5.NET Framework 4.5 to support legacy code; however, the new async methods, such as ReadAsync, WriteAsync, CopyToAsync, and FlushAsync, help you implement asynchronous I/O operations more easily.

La implementación predeterminada de BeginWrite en un flujo llama al Write método sincrónicamente, lo Write que significa que podría bloquearse en algunos flujos.The default implementation of BeginWrite on a stream calls the Write method synchronously, which means that Write might block on some streams. Sin embargo, las instancias de clases FileStream como NetworkStream y admiten totalmente operaciones asincrónicas si las instancias de se han abierto de forma asincrónica.However, instances of classes such as FileStream and NetworkStream fully support asynchronous operations if the instances have been opened asynchronously. Por lo tanto, BeginWrite las llamadas a no se bloquearán en esos flujos.Therefore, calls to BeginWrite will not block on those streams. Puede invalidar BeginWrite (mediante delegados asincrónicos, por ejemplo) para proporcionar un comportamiento asincrónico.You can override BeginWrite (by using async delegates, for example) to provide asynchronous behavior.

Pase el IAsyncResult valor devuelto por el método EndWrite actual a para asegurarse de que la escritura se completa y libera los recursos adecuadamente.Pass the IAsyncResult returned by the current method to EndWrite to ensure that the write completes and frees resources appropriately. EndWritese debe llamar una vez para cada llamada BeginWritea.EndWrite must be called once for every call to BeginWrite. Para ello, puede usar el mismo código que llamó BeginWrite a o en una devolución de llamada que se pasa a. BeginWriteYou can do this either by using the same code that called BeginWrite or in a callback passed to BeginWrite. Si se produce un error durante una escritura asincrónica, no se producirá una excepción hasta EndWrite que se llame a IAsyncResult con el devuelto por este método.If an error occurs during an asynchronous write, an exception will not be thrown until EndWrite is called with the IAsyncResult returned by this method.

Si se puede escribir en una secuencia, al escribir al final de la secuencia se expande la secuencia.If a stream is writable, writing at the end of the stream expands the stream.

La posición actual en la secuencia se actualiza cuando se emite la lectura o escritura asincrónica, no cuando se completa la operación de e/s.The current position in the stream is updated when you issue the asynchronous read or write, not when the I/O operation completes. Varias solicitudes asincrónicas simultáneas representan el orden de finalización de la solicitud de forma no segura.Multiple simultaneous asynchronous requests render the request completion order uncertain.

Utilice la CanWrite propiedad para determinar si la instancia actual admite escritura.Use the CanWrite property to determine whether the current instance supports writing.

Si una secuencia está cerrada o se pasa un argumento no válido, las excepciones se producen BeginWriteinmediatamente desde.If a stream is closed or you pass an invalid argument, exceptions are thrown immediately from BeginWrite. Los errores que se producen durante una solicitud de escritura asincrónica, como un error de disco durante la solicitud de e/s, se producen en el subproceso del grupo EndWritede subprocesos y producen excepciones al llamar a.Errors that occur during an asynchronous write request, such as a disk failure during the I/O request, occur on the thread pool thread and throw exceptions when calling EndWrite.

Se aplica a

Consulte también: