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

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

Observação

A partir do .NET Core 2.0, CancelAsync não cancela a solicitação imediatamente se a resposta tiver começado a ser buscada. Para um comportamento de cancelamento ideal, use a HttpClient classe 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 DownloadStringAsync operação, se tiver especificado um manipulador de eventos para o evento, o DownloadStringCompleted manipulador de eventos receberá uma notificação de que a operação terminou. Para saber se a operação foi concluída com êxito, marcar a Cancelled propriedade na classe base de no objeto de DownloadDataCompletedEventArgs 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.