WebClient.CancelAsync Metodo

Definizione

Spazio dei nomi:

System.Net

Assembly:

System.Net.WebClient.dll

Source:

WebClient.cs

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, se è stato specificato un DownloadStringAsync gestore eventi per l'evento DownloadStringCompleted , il gestore eventi riceve una notifica che l'operazione è stata terminata. Per informazioni 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 fa nulla.