WebClient.CancelAsync Metódus

Definíció

Névtér:

System.Net

Szerelvények:

netstandard.dll, System.Net.WebClient.dll

Forrás:

WebClient.cs

Megszakít egy függőben lévő aszinkron műveletet.

public:
 void CancelAsync();

public void CancelAsync();

member this.CancelAsync : unit -> unit

Public Sub CancelAsync ()

Megjegyzések

Figyelmeztetés

WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.

Ha egy művelet függőben van, ez a metódus meghívja Abort a mögöttes műveletet WebRequest.

Note

A .NET Core 2.0-tól kezdődően CancelAsync nem mondja le azonnal a kérést, ha a válasz beolvasása elkezdődött. Az optimális lemondási viselkedéshez használja az osztályt ahelyettHttpClient, hogy a WebClient .

Híváskor CancelAsyncaz alkalmazás továbbra is megkapja a művelethez társított befejezési eseményt. Ha például egy művelet megszakítására hív CancelAsync meg egy DownloadStringAsync eseménykezelőt DownloadStringCompleted , az eseménykezelő értesítést kap arról, hogy a művelet befejeződött. Ha szeretné megtudni, hogy a művelet sikeresen befejeződött-e, ellenőrizze az Cancelled eseményadat-objektum alaposztályának DownloadDataCompletedEventArgs az eseménykezelőnek átadott tulajdonságát.

Ha nincs folyamatban aszinkron művelet, ez a metódus nem tesz semmit.