WebClient.CancelAsync 方法

定义

取消挂起的异步操作。

public:
 void CancelAsync();
public void CancelAsync ();
member this.CancelAsync : unit -> unit
Public Sub CancelAsync ()

注解

谨慎

WebRequestHttpWebRequestServicePointWebClient 已过时,不应将其用于新开发。 请改用 HttpClient

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

注意

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

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

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

适用于