WebClient.CancelAsync Метод

Определение

Пространство имен:

System.Net

Сборка:

System.Net.WebClient.dll

Исходный код:

WebClient.cs

Отменяет ожидающая асинхронная операция.

public:
 void CancelAsync();

public void CancelAsync ();

member this.CancelAsync : unit -> unit

Public Sub CancelAsync ()

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.

Если операция ожидается, этот метод вызывает Abort в базовой WebRequest.

Заметка

Начиная с .NET Core 2.0, CancelAsync не отменяет запрос немедленно, если ответ начал получение. Для оптимального поведения отмены используйте класс HttpClient вместо WebClient.

При вызове CancelAsyncприложение по-прежнему получает событие завершения, связанное с операцией. Например, при вызове CancelAsync для отмены операции DownloadStringAsync, если вы указали обработчик событий для события DownloadStringCompleted, обработчик событий получает уведомление о завершении операции. Чтобы узнать, выполнена ли операция успешно, проверьте свойство Cancelled базового класса DownloadDataCompletedEventArgs в объекте данных события, переданном обработчику событий.

Если асинхронная операция не выполняется, этот метод ничего не делает.