WebClient.CancelAsync Metoda

Definice

Obor názvů:

System.Net

Sestavení:

netstandard.dll, 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 základní WebRequest.

Poznámka

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

Při volání CancelAsyncaplikace stále obdrží událost dokončení přidruženou k operaci. Například při volání CancelAsync zrušení DownloadStringAsync operace, pokud jste zadali obslužnou rutinu události pro DownloadStringCompleted událost, obslužná rutina události obdrží oznámení, že operace skončila. Pokud chcete zjistit, jestli se operace úspěšně dokončila, zkontrolujte Cancelled vlastnost základní třídy datového DownloadDataCompletedEventArgs objektu události předaného obslužné rutině události.

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