Stream.EndWrite(IAsyncResult) Método

Definición

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

public:
 virtual void EndWrite(IAsyncResult ^ asyncResult);
public virtual void EndWrite (IAsyncResult asyncResult);
abstract member EndWrite : IAsyncResult -> unit
override this.EndWrite : IAsyncResult -> unit
Public Overridable Sub EndWrite (asyncResult As IAsyncResult)

Parámetros

asyncResult
IAsyncResult

Una referencia a la solicitud de E/S asincrónica pendiente.A reference to the outstanding asynchronous I/O request.

Excepciones

El valor de asyncResult es null.asyncResult is null.

Un identificador para la operación de escritura pendiente no está disponible.A handle to the pending write operation is not available.

O bien,-or-

La operación pendiente no admite escritura.The pending operation does not support writing.

asyncResult no se originó desde un método BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) de la secuencia actual.asyncResult did not originate from a BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) method on the current stream.

La secuencia está cerrada o se produjo un error interno.The stream is closed or an internal error has occurred.

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.

se debe llamar a EndWrite exactamente una vez en cada IAsyncResult de BeginWrite.EndWrite must be called exactly once on every IAsyncResult from BeginWrite.

Este método se bloquea hasta que se haya completado la operación de E/S.This method blocks until the I/O operation has completed. 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 se vuelven visibles en una llamada 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 become visible upon a call to EndWrite. Las excepciones producidas por el subproceso del grupo de subprocesos no estarán visibles al llamar a EndWrite.Exceptions thrown by the thread pool thread will not be visible when calling EndWrite.

Se aplica a

Consulte también: