WebClient.CancelAsync Metoda

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.WebClient.dll

Zdroj:

WebClient.cs

Zruší čekající asynchronní operaci.

public:
 void CancelAsync();

public void CancelAsync ();

member this.CancelAsync : unit -> unit

Public Sub CancelAsync ()

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Pokud operace čeká na vyřízení, tato metoda volá Abort na podkladové WebRequest.

Poznámka

Od verze .NET Core 2.0 CancelAsync požadavek okamžitě nezruší, pokud se odpověď začala načítat. Pro optimální chování zrušení použijte třídu HttpClient místo WebClient.

Při volání CancelAsyncaplikace stále obdrží událost dokončení přidruženou k operaci. Když například zavoláte CancelAsync zrušit operaci DownloadStringAsync, pokud jste pro událost DownloadStringCompleted zadali obslužnou rutinu události, obslužná rutina události obdrží oznámení, že operace skončila. Chcete-li zjistit, zda operace byla úspěšně dokončena, zkontrolujte vlastnost Cancelled základní třídy DownloadDataCompletedEventArgs v datovém objektu události předané obslužné rutině události.

Pokud neprobíhá žádná asynchronní operace, tato metoda nic nedělá.