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

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