Stream.EndWrite(IAsyncResult) 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

來源:

Stream.cs

結束非同步的寫入作業。 (請考慮用 WriteAsync(Byte[], Int32, Int32) 替代。)

public:
 virtual void EndWrite(IAsyncResult ^ asyncResult);

public virtual void EndWrite (IAsyncResult asyncResult);

abstract member EndWrite : IAsyncResult -> unit
override this.EndWrite : IAsyncResult -> unit

Public Overridable Sub EndWrite (asyncResult As IAsyncResult)

參數

asyncResult

IAsyncResult

未處理的非同步 I/O 要求的參考。

例外狀況

ArgumentNullException

asyncResult 為 null。

ArgumentException

暫止寫入作業的控制代碼無法使用。

-或-

暫止的作業不支援寫入。

InvalidOperationException

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

IOException

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

備註

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

EndWrite每個都必須從BeginWrite呼叫一次IAsyncResult。

這個方法會封鎖，直到 I/O 作業完成為止。 異步寫入要求期間發生的錯誤，例如 I/O 要求期間的磁碟失敗，會在線程集區線程上發生，並在呼叫 EndWrite時顯示。 呼叫 EndWrite時，線程集區線程擲回的例外狀況將不會顯示。

另請參閱

• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案
• Asynchronous File I/O