Stream.EndWrite(IAsyncResult) Méthode

Définition

Termine une opération d'écriture asynchrone.Ends an asynchronous write operation. (Utilisez WriteAsync(Byte[], Int32, Int32) à la place.)(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)

Paramètres

asyncResult
IAsyncResult

Référence à la requête d'E/S asynchrone en attente.A reference to the outstanding asynchronous I/O request.

Exceptions

asyncResult a la valeur null.asyncResult is null.

Un handle vers l’opération d’écriture en attente n’est pas disponible.A handle to the pending write operation is not available.

- ou --or-

L’opération en attente ne prend pas en charge l’écriture.The pending operation does not support writing.

asyncResult ne provenait pas d’une méthode BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) sur le flux en cours.asyncResult did not originate from a BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) method on the current stream.

Le flux est fermé ou une erreur interne s’est produite.The stream is closed or an internal error has occurred.

Remarques

Dans .NET Framework 4 et les versions antérieures, on doit utiliser des méthodes telles que BeginWrite et EndWrite pour implémenter les opérations d'E/S asynchrones.In the .NET Framework 4 and earlier versions, you have to use methods such as BeginWrite and EndWrite to implement asynchronous I/O operations. Ces méthodes sont toujours disponibles dans .NET Framework 4.5.NET Framework 4.5 pour prendre en charge le code hérité. Toutefois, les nouvelles méthodes Async, telles que ReadAsync ,, WriteAsync CopyToAsync et FlushAsync , vous aident à implémenter les opérations d’e/s asynchrones plus facilement.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.

EndWrite doit être appelé une seule fois sur chaque IAsyncResult à partir de BeginWrite .EndWrite must be called exactly once on every IAsyncResult from BeginWrite.

Cette méthode est bloquée jusqu'à la fin de l'opération d'E/S.This method blocks until the I/O operation has completed. Les erreurs qui se produisent pendant une requête d’écriture asynchrone, telles qu’une défaillance du disque pendant la requête d’e/s, se produisent sur le thread du pool de threads et deviennent visibles lors d’un appel à 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. Les exceptions levées par le thread du pool de threads ne sont pas visibles lors de l’appel de EndWrite .Exceptions thrown by the thread pool thread will not be visible when calling EndWrite.

S’applique à

Voir aussi