WebClient.CancelAsync 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取消暫止的非同步作業。
public:
void CancelAsync();
public void CancelAsync ();
member this.CancelAsync : unit -> unit
Public Sub CancelAsync ()
備註
如果作業擱置中,這個方法會在基礎 WebRequest 上呼叫 Abort 。
注意
從 .NET Core 2.0 開始,如果回應已開始擷取, CancelAsync 就不會立即取消要求。 若要獲得最佳的取消行為,請使用 HttpClient 類別,而不是 WebClient 。
當您呼叫 CancelAsync 時,您的應用程式仍會收到與作業相關聯的完成事件。 例如,當您呼叫 CancelAsync 取消 DownloadStringAsync 作業時,如果您已指定 事件的事件處理常式 DownloadStringCompleted ,事件處理常式就會收到作業已結束的通知。 若要瞭解作業是否已順利完成,請檢查 Cancelled 傳遞至事件處理常式之事件資料物件中 之 基類 DownloadDataCompletedEventArgs 上的 屬性。
如果沒有進行非同步作業,則這個方法不會執行任何動作。
適用於
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應