Share via


WebClient.CancelAsync Metode

Definisi

Membatalkan operasi asinkron yang tertunda.

public:
 void CancelAsync();
public void CancelAsync ();
member this.CancelAsync : unit -> unit
Public Sub CancelAsync ()

Keterangan

Jika operasi tertunda, metode ini memanggil pada yang mendasar AbortWebRequest.

Catatan

Mulai dari .NET Core 2.0, CancelAsync tidak segera membatalkan permintaan jika respons telah mulai diambil. Untuk perilaku pembatalan optimal, gunakan kelas alih-alih HttpClientWebClient.

Saat Anda memanggil CancelAsync, aplikasi Anda masih menerima peristiwa penyelesaian yang terkait dengan operasi. Misalnya, saat Anda memanggil CancelAsync untuk membatalkan DownloadStringAsync operasi, jika Anda telah menentukan penanganan aktivitas untuk peristiwa tersebut DownloadStringCompleted , penanganan aktivitas Anda menerima pemberitahuan bahwa operasi telah berakhir. Untuk mempelajari apakah operasi berhasil diselesaikan, periksa Cancelled properti pada kelas DownloadDataCompletedEventArgs dasar dalam objek data peristiwa yang diteruskan ke penanganan aktivitas.

Jika tidak ada operasi asinkron yang sedang berlangsung, metode ini tidak melakukan apa pun.

Berlaku untuk