NetworkStream.EndRead(IAsyncResult) 方法

定義

處理非同步讀取的結束。

C#
public override int EndRead (IAsyncResult asyncResult);

參數

asyncResult
IAsyncResult

IAsyncResult,表示非同步呼叫。

傳回

NetworkStream 讀取的位元組數。

例外狀況

asyncResult 參數為 null

基礎 Socket 已經關閉。

-或-

存取通訊端時發生錯誤。

備註

重要

這是相容性 API,不建議使用 APM (Begin / End) 方法進行新的開發。 請改用以工作為基礎的對等專案。

方法 EndRead 會完成 方法所啟動的 BeginRead 讀取作業。 您必須傳遞 IAsyncResultBeginRead 對呼叫所建立的 。 EndRead 將會封鎖呼叫線程,直到作業完成為止。

作業會讀取可用的數據量,最多為 參數所 size 指定的位元元組數目。

備註

如果您收到 IOException,請檢查 InnerException 屬性,以判斷它是否由 SocketException所造成。 如果是,請使用 ErrorCode 屬性來取得特定的錯誤碼。

適用於

產品 版本
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

另請參閱