WebClient.CancelAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Annulla un'operazione asincrona in sospeso.
public:
void CancelAsync();public void CancelAsync ();member this.CancelAsync : unit -> unitPublic 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.
