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, HttpWebRequeste ServicePointWebClient são obsoletos e você não deve usá-los para um novo desenvolvimento. Use HttpClient em seu lugar.
Se uma operação estiver pendente, esse método chamará Abort o subjacente WebRequest.
Nota
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 você especificou um manipulador de eventos para o evento, o DownloadStringCompleted manipulador de eventos recebe a notificação de que a operação terminou. Para saber se a operação foi concluída com êxito, verifique a Cancelled propriedade na classe base do 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.
