Stream.EndRead(IAsyncResult) 方法

  • 參考

定義

命名空間:
System.IO
組件:
System.Runtime.dll
組件:
mscorlib.dll
組件:
netstandard.dll
來源:
Stream.cs
來源:
Stream.cs
來源:
Stream.cs

等候暫止的非同步讀取完成。 (請考慮用 ReadAsync(Byte[], Int32, Int32) 替代。)

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

參數

asyncResult
IAsyncResult

要完成的擱置中非同步要求的參考。

傳回

Int32

從數據流讀取的位元組數目，介於零 (0) 和要求的位元元組數目之間。 ReadAsync 只會在要求零個字節時傳回零 (0) ;如果沒有其他位元組可供使用，因為它位於數據流結尾;否則，讀取作業在至少一個字節可用之前不會完成。 如果要求零個字節，讀取作業可能會立即完成，或直到至少有一個字節可供使用 (，但不需要耗用任何數據) 為止。

例外狀況

ArgumentNullException

asyncResult 為 null。

ArgumentException

暫止讀取作業的控制代碼無法使用。

-或-

暫止的作業不支援讀取。

InvalidOperationException

asyncResult 不是來自目前資料流的 BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) 方法。

IOException

資料流已關閉或發生內部錯誤。

備註

在 .NET Framework 4 (含) 以前版本中，您必須使用方法 (例如 BeginRead 和 EndRead ) 實作非同步 I/O 作業。 這些方法仍可在 .NET Framework 4.5 中使用，以支援舊版程式代碼;不過，新的異步方法，例如 ReadAsync、WriteAsync、 CopyToAsync和 FlushAsync，可協助您更輕鬆地實作異步 I/O 作業。

呼叫 EndRead 以判斷從數據流讀取多少個字節。

EndRead每個都可以從BeginRead呼叫IAsyncResult一次。

這個方法會封鎖，直到 I/O 作業完成為止。

適用於

另請參閱