Stream.EndWrite(IAsyncResult) Méthode

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

Source:

Stream.cs

Termine une opération d'écriture asynchrone. (Utilisez WriteAsync(Byte[], Int32, Int32) à la place.)

C#

public virtual void EndWrite (IAsyncResult asyncResult);

Paramètres

asyncResult

IAsyncResult

Référence à la requête d'E/S asynchrone en attente.

Exceptions

ArgumentNullException

asyncResult a la valeur null.

ArgumentException

Un handle vers l’opération d’écriture en attente n’est pas disponible.

- ou -

L’opération en attente ne prend pas en charge l’écriture.

InvalidOperationException

asyncResult ne provenait pas d’une méthode BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) sur le flux en cours.

IOException

Le flux est fermé ou une erreur interne s’est produite.

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. Ces méthodes sont toujours disponibles dans .NET Framework 4.5 pour prendre en charge le code hérité ; Toutefois, les nouvelles méthodes asynchrones, telles que ReadAsync, WriteAsync, CopyToAsyncet FlushAsync, vous aident à implémenter plus facilement des opérations d’E/S asynchrones.

EndWrite doit être appelé exactement une fois sur chaque IAsyncResult de BeginWrite.

Cette méthode est bloquée jusqu'à la fin de l'opération d'E/S. Les erreurs qui se produisent lors d’une demande d’écriture asynchrone, telles qu’une défaillance de disque pendant la demande d’E/S, se produisent sur le thread du pool de threads et deviennent visibles lors d’un appel à EndWrite. Les exceptions levées par le thread du pool de threads ne seront pas visibles lors de l’appel EndWritede .

S’applique à

Voir aussi

• Fichier et flux de données E/S
• Procédure : lire le texte d’un fichier
• Procédure : écrire du texte dans un fichier
• E/S sur fichier asynchrones