Stream.EndRead(IAsyncResult) Méthode

  • Référence

Définition

Espace de noms:
System.IO
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Source:
Stream.cs
Source:
Stream.cs
Source:
Stream.cs

Attend que la requête asynchrone en attente se termine. (Utilisez ReadAsync(Byte[], Int32, Int32) à la place.)

public:
 virtual int EndRead(IAsyncResult ^ asyncResult);
public virtual int EndRead (IAsyncResult asyncResult);
abstract member EndRead : IAsyncResult -> int
override this.EndRead : IAsyncResult -> int
Public Overridable Function EndRead (asyncResult As IAsyncResult) As Integer

Paramètres

asyncResult
IAsyncResult

Référence à la requête asynchrone en attente à terminer.

Retours

Int32

Nombre d’octets lus à partir du flux, entre zéro (0) et nombre d’octets demandés. ReadAsync retourne zéro (0) uniquement si zéro octet a été demandé ou si aucun autre octet ne sera disponible, car il se trouve à la fin du flux ; sinon, les opérations de lecture ne se terminent pas tant qu’au moins un octet n’est pas disponible. Si zéro octet est demandé, les opérations de lecture peuvent se terminer immédiatement ou ne pas se terminer tant qu’au moins un octet n’est pas disponible (mais sans consommer de données).

Exceptions

ArgumentNullException

asyncResult a la valeur null.

ArgumentException

Handle vers l’opération de lecture en attente non disponible.

- ou -

L’opération en attente ne prend pas en charge la lecture.

InvalidOperationException

asyncResult ne provenait pas d’une méthode BeginRead(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 BeginRead et EndRead 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.

Appelez EndRead pour déterminer le nombre d’octets lus à partir du flux.

EndRead peut être appelé une fois sur chaque IAsyncResult à partir de BeginRead.

Cette méthode est bloquée jusqu'à la fin de l'opération d'E/S.

S’applique à

Voir aussi