WebClient.CancelAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Отменяет ожидающая асинхронная операция.
public:
void CancelAsync();public void CancelAsync();member this.CancelAsync : unit -> unitPublic Sub CancelAsync ()Внимание!
WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.
Если операция ожидается, этот метод вызывает Abort в базовой WebRequest.
Примечание
Начиная с .NET Core 2.0, CancelAsync не отменяет запрос немедленно, если ответ начал получение. Для оптимального поведения отмены используйте класс HttpClient вместо WebClient.
При вызове CancelAsyncприложение по-прежнему получает событие завершения, связанное с операцией. Например, при вызове CancelAsync для отмены операции DownloadStringAsync, если вы указали обработчик событий для события DownloadStringCompleted, обработчик событий получает уведомление о завершении операции. Чтобы узнать, выполнена ли операция успешно, проверьте свойство Cancelled базового класса DownloadDataCompletedEventArgs в объекте данных события, переданном обработчику событий.
Если асинхронная операция не выполняется, этот метод ничего не делает.
Применяется к
| Продукт | Версии |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
