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、HttpWebRequest、ServicePoint和 WebClient 已过时，不应将其用于新开发。 请改用 HttpClient。

如果某个操作挂起，此方法对基础 WebRequest调用 Abort。

注意

从 .NET Core 2.0 开始，如果响应已开始提取，CancelAsync 不会立即取消请求。 为获得最佳取消行为，请使用 HttpClient 类而不是 WebClient。

调用 CancelAsync时，应用程序仍会收到与操作关联的完成事件。 例如，调用 CancelAsync 取消 DownloadStringAsync 操作时，如果为 DownloadStringCompleted 事件指定了事件处理程序，则事件处理程序会收到操作已结束的通知。 若要了解操作是否已成功完成，请在传递给事件处理程序的事件数据对象中检查 DownloadDataCompletedEventArgs 基类的 Cancelled 属性。

如果未进行异步操作，此方法将不执行任何操作。