WebClient.CancelAsync 方法

定義

命名空間:

System.Net

組件:

System.Net.WebClient.dll

來源:

WebClient.cs

取消暫止的非同步作業。

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 上的 屬性。

如果沒有進行非同步作業，則這個方法不會執行任何動作。