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

Cautela

WebRequest, HttpWebRequest, ServicePointe WebClient sono obsoleti e non è consigliabile usarli per nuovi sviluppi. Usare invece HttpClient.

Se un'operazione è in sospeso, questo metodo chiama Abort sul WebRequestsottostante.

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 classe HttpClient 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 di DownloadStringAsync, se è stato specificato un gestore eventi per l'evento DownloadStringCompleted, il gestore eventi riceve la notifica che l'operazione è terminata. Per sapere se l'operazione è stata completata correttamente, controllare la proprietà Cancelled nella 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