WebClient.CancelAsync Metodo

Definizione

Annulla un'operazione asincrona in sospeso.

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

Commenti

Se un'operazione è in sospeso, questo metodo chiama Abort sull'oggetto sottostante WebRequest.

Nota

A partire da .NET Core 2.0, CancelAsync non annulla immediatamente la richiesta se la risposta ha iniziato a recuperare. Per un comportamento di annullamento ottimale, usare la HttpClient classe anziché WebClient.

Quando si chiama CancelAsync, l'applicazione riceve comunque l'evento di completamento associato all'operazione. Ad esempio, quando si chiama CancelAsync per annullare un'operazione DownloadStringAsync , se è stato specificato un gestore eventi per l'evento DownloadStringCompleted , il gestore eventi riceve la notifica che l'operazione è terminata. Per verificare se l'operazione è stata completata correttamente, controllare la Cancelled proprietà sulla classe base di DownloadDataCompletedEventArgs nell'oggetto dati dell'evento passato al gestore eventi.

Se non è in corso alcuna operazione asincrona, questo metodo non esegue alcuna operazione.

Si applica a