Stream.EndRead(IAsyncResult) Méthode

Définition

Attend que la requête asynchrone en attente se termine.Waits for the pending asynchronous read to complete. (Utilisez ReadAsync(Byte[], Int32, Int32) à la place.)(Consider using ReadAsync(Byte[], Int32, Int32) instead.)

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.The reference to the pending asynchronous request to finish.

Retours

Int32

Nombre d'octets lus dans le flux, entre zéro (0) et le nombre demandé.The number of bytes read from the stream, between zero (0) and the number of bytes you requested. Les flux retournent uniquement zéro (0) à la fin du flux ; sinon, ils devraient se bloquer jusqu'à ce qu'au moins un octet soit disponible.Streams return zero (0) only at the end of the stream, otherwise, they should block until at least one byte is available.

Exceptions

asyncResult a la valeur null.asyncResult is null.

Handle vers l’opération de lecture en attente non disponible.A handle to the pending read operation is not available.

- ou --or-

L’opération en attente ne prend pas en charge la lecture.The pending operation does not support reading.

asyncResult ne provenait pas d’une méthode BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) sur le flux en cours.asyncResult did not originate from a BeginRead(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 BeginRead et EndRead 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 BeginRead and EndRead 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.

Appelez EndRead pour déterminer le nombre d’octets lus à partir du flux.Call EndRead to determine how many bytes were read from the stream.

EndRead peut être appelé une fois sur chaque IAsyncResult à partir de BeginRead .EndRead can be called once on every IAsyncResult from BeginRead.

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.

S’applique à

Voir aussi