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

El búfer desde donde se deben escribir los 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

El número máximo de bytes que se van a escribir.The maximum number of bytes to write.

callback
AsyncCallback

Una devolución de llamada asincrónica opcional, para llamarla cuando la escritura haya finalizado.An optional asynchronous callback, to be called when the write is complete.

state
Object

Un objeto proporcionado por el usuario que distingue esta solicitud de escritura asincrónica determinada de otras solicitudes.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 estando disponibles en la .NET Framework 4.5.NET Framework 4.5 para admitir código heredado. sin embargo, los nuevos métodos asincrónicos, como ReadAsync, WriteAsync, CopyToAsyncy FlushAsync, le 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 método Write sincrónicamente, lo que significa que Write 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 como FileStream y NetworkStream admiten todas las 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, las llamadas a BeginWrite 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 devuelto por el método actual a EndWrite 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. se debe llamar a EndWrite una vez por cada llamada a BeginWrite.EndWrite must be called once for every call to BeginWrite. Para ello, puede usar el mismo código que llamó BeginWrite o en una devolución de llamada que se pasa a BeginWrite.You 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 que se llame a EndWrite con el IAsyncResult 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 propiedad CanWrite 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 inmediatamente desde BeginWrite.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 de subprocesos y producen excepciones al llamar a EndWrite.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: