WebClient.CancelAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Cancela uma operação assíncrona pendente.
public:
void CancelAsync();public void CancelAsync ();member this.CancelAsync : unit -> unitPublic 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.
