WebClient.CancelAsync 方法

定义

命名空间:

System.Net

程序集:

System.Net.WebClient.dll

Source:

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

如果没有异步操作正在进行中，此方法不执行任何操作。