WebClient.CancelAsync Método

Definição

Namespace:

System.Net

Assembly:

System.Net.WebClient.dll

Origem:

WebClient.cs

Cancela uma operação assíncrona pendente.

public:
 void CancelAsync();

public void CancelAsync ();

member this.CancelAsync : unit -> unit

Public Sub CancelAsync ()

Comentários

Cuidado

WebRequest, HttpWebRequest, ServicePointe WebClient estão obsoletos e você não deve usá-los para um novo desenvolvimento. Em vez disso, use HttpClient.

Se uma operação estiver pendente, esse método chamará Abort no WebRequestsubjacente.

Nota

A partir do .NET Core 2.0, CancelAsync não cancelará a solicitação imediatamente se a resposta tiver começado a ser buscada. Para um comportamento de cancelamento ideal, use a classe HttpClient em vez de WebClient.

Quando você chama CancelAsync, seu aplicativo ainda recebe o evento de conclusão associado à operação. Por exemplo, quando você chama CancelAsync para cancelar uma operação de DownloadStringAsync, se tiver especificado um manipulador de eventos para o evento DownloadStringCompleted, o manipulador de eventos receberá a notificação de que a operação terminou. Para saber se a operação foi concluída com êxito, verifique a propriedade Cancelled na classe base de DownloadDataCompletedEventArgs no objeto de dados de evento passado para o manipulador de eventos.

Se nenhuma operação assíncrona estiver em andamento, esse método não fará nada.