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, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.
Jika operasi tertunda, metode ini memanggil Abort pada WebRequestyang mendasar .
Nota
Mulai dari .NET Core 2.0, CancelAsync tidak segera membatalkan permintaan jika respons telah mulai diambil. Untuk perilaku pembatalan optimal, gunakan kelas HttpClient alih-alih WebClient.
Saat Anda memanggil CancelAsync, aplikasi Anda masih menerima peristiwa penyelesaian yang terkait dengan operasi. Misalnya, saat Anda memanggil CancelAsync untuk membatalkan operasi DownloadStringAsync, jika Anda telah menentukan penanganan aktivitas untuk peristiwa DownloadStringCompleted, penanganan aktivitas Anda menerima pemberitahuan bahwa operasi telah berakhir. Untuk mempelajari apakah operasi berhasil diselesaikan, periksa properti Cancelled pada kelas dasar DownloadDataCompletedEventArgs dalam objek data peristiwa yang diteruskan ke penanganan aktivitas.
Jika tidak ada operasi asinkron yang sedang berlangsung, metode ini tidak melakukan apa pun.
