WebClient.OnDownloadFileCompleted(AsyncCompletedEventArgs) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Вызывает событие DownloadFileCompleted.
protected:
virtual void OnDownloadFileCompleted(System::ComponentModel::AsyncCompletedEventArgs ^ e);
protected virtual void OnDownloadFileCompleted (System.ComponentModel.AsyncCompletedEventArgs e);
abstract member OnDownloadFileCompleted : System.ComponentModel.AsyncCompletedEventArgs -> unit
override this.OnDownloadFileCompleted : System.ComponentModel.AsyncCompletedEventArgs -> unit
Protected Overridable Sub OnDownloadFileCompleted (e As AsyncCompletedEventArgs)
Параметры
Объект AsyncCompletedEventArgs, содержащий данные события.
Примеры
В следующем примере кода показана реализация этого метода, который можно настроить классом, производным от WebClient.
virtual void OnDownloadFileCompleted( System::ComponentModel::AsyncCompletedEventArgs ^ e ) override
{
// Here you can perform any custom actions before the event is raised
// and event handlers are called...
WebClient::OnDownloadFileCompleted( e );
// Here you can perform any post event actions...
}
protected override void OnDownloadFileCompleted (System.ComponentModel.AsyncCompletedEventArgs e)
{
// Here you can perform any custom actions before the event is raised
// and event handlers are called...
base.OnDownloadFileCompleted(e);
// Here you can perform any post event actions...
}
Комментарии
Осторожность
WebRequest
, HttpWebRequest
, ServicePoint
и WebClient
устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.
Классы, наследуемые от этого класса, могут переопределить этот метод для выполнения дополнительных задач при возникновении события DownloadFileCompleted.
При вызове события обработчик событий вызывается через делегат. Дополнительные сведения см. в обработке и вызове событий.
Метод OnDownloadFileCompleted также позволяет производным классам обрабатывать событие без присоединения делегата. Это предпочтительный способ обработки события в производном классе.
Примечания для тех, кто наследует этот метод
При переопределении OnDownloadFileCompleted(AsyncCompletedEventArgs) в производном классе обязательно вызовите метод OnDownloadFileCompleted(AsyncCompletedEventArgs) базового класса, чтобы зарегистрированные делегаты получали событие.