WebClient.CancelAsync Метод

Определение

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

System.Net

Сборки:

netstandard.dll, 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приложение по-прежнему получает событие завершения, связанное с операцией. Например, при вызове CancelAsyncDownloadStringAsync отмены операции, если вы указали обработчик событий для DownloadStringCompleted события, обработчик событий получает уведомление о завершении операции. Чтобы узнать, успешно ли выполнена операция, проверьте Cancelled свойство базового класса DownloadDataCompletedEventArgs объекта данных события, переданного обработчику событий.

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