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
ServicePoint, HttpWebRequest, e WebClient sono obsoleti e non è consigliabile usarli per il nuovo sviluppo. Utilizzare invece HttpClient.
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 sapere se l'operazione è stata completata correttamente, controllare la Cancelled proprietà nella classe di 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.
