Stream.EndRead(IAsyncResult) Stream.EndRead(IAsyncResult) Stream.EndRead(IAsyncResult) Stream.EndRead(IAsyncResult) Method

Definition

Namespace:
System.IO System.IO System.IO System.IO
Assemblies:
mscorlib.dll, netstandard.dll, System.Runtime.dll, System.IO.dll

Wartet, bis der ausstehende asynchrone Lesevorgang abgeschlossen ist.Waits for the pending asynchronous read to complete. (Verwenden Sie stattdessen ReadAsync(Byte[], Int32, Int32).)(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

Parameter

asyncResult
IAsyncResult IAsyncResult IAsyncResult IAsyncResult

Der Verweis auf die ausstehende asynchrone Anforderung, die beendet werden soll.The reference to the pending asynchronous request to finish.

Gibt zurück

Int32 Int32 Int32 Int32

Die Anzahl der aus dem Stream gelesenen Bytes. Diese Anzahl kann zwischen 0 und der Anzahl der angeforderten Bytes liegen.The number of bytes read from the stream, between zero (0) and the number of bytes you requested. Streams geben nur am Ende des Streams 0 zurück, andernfalls sollten sie blockieren, bis mindestens 1 Byte verfügbar ist.Streams return zero (0) only at the end of the stream, otherwise, they should block until at least one byte is available.

Ausnahmen

ArgumentNullException ArgumentNullException ArgumentNullException ArgumentNullException

asyncResult ist null.asyncResult is null.

ArgumentException ArgumentException ArgumentException ArgumentException

Ein Handle für den ausstehenden Lesevorgang ist nicht verfügbar.A handle to the pending read operation is not available.

- oder --or-

Die anstehende Operation unterstützt keine Lesevorgänge.The pending operation does not support reading.

InvalidOperationException InvalidOperationException InvalidOperationException InvalidOperationException

asyncResult basiert nicht auf einer BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)-Methode im aktuellen Stream.asyncResult did not originate from a BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) method on the current stream.

IOException IOException IOException IOException

Der Stream ist geschlossen, oder ein interner Fehler ist aufgetreten.The stream is closed or an internal error has occurred.

Hinweise

In .NET Framework 4 und vorherigen Versionen müssen Sie Methoden wie BeginRead und EndRead verwenden, um asynchrone E/A-Vorgänge zu implementieren.In the .NET Framework 4 and earlier versions, you have to use methods such as BeginRead and EndRead to implement asynchronous I/O operations. Diese Methoden sind .NET Framework 4.5.NET Framework 4.5 weiterhin in verfügbar, um Legacy Code zu unterstützen. die neuen Async-Methoden, ReadAsyncwie z WriteAsync. b. FlushAsync,, CopyToAsyncund, unterstützen Sie jedoch bei der einfacheren Implementierung asynchroner e/a-Vorgänge.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.

Ruft EndRead auf, um zu bestimmen, wie viele Bytes aus dem Stream gelesen wurden.Call EndRead to determine how many bytes were read from the stream.

EndReadkann bei jedem IAsyncResult von BeginReadeinmal aufgerufen werden.EndRead can be called once on every IAsyncResult from BeginRead.

Diese Methode blockiert, bis die E/A-Operation abgeschlossen ist.This method blocks until the I/O operation has completed.

Gilt für:

Siehe auch