WebClient.CancelAsync Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Membatalkan operasi asinkron yang tertunda.
public:
void CancelAsync();public void CancelAsync();member this.CancelAsync : unit -> unitPublic Sub CancelAsync ()Keterangan
Hati
WebRequest, , HttpWebRequestServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.
Jika operasi tertunda, metode ini memanggil Abort pada WebRequest.
Nota
Mulai dari .NET Core 2.0, CancelAsync tidak segera membatalkan permintaan jika respons telah mulai diambil. Untuk perilaku pembatalan optimal, gunakan HttpClient kelas alih-alih WebClient.
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.
