WebClient.OnDownloadProgressChanged(DownloadProgressChangedEventArgs) Метод

Определение

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

System.Net

Сборка:

System.Net.WebClient.dll

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

WebClient.cs

Вызывает событие DownloadProgressChanged.

protected:
 virtual void OnDownloadProgressChanged(System::Net::DownloadProgressChangedEventArgs ^ e);

protected virtual void OnDownloadProgressChanged (System.Net.DownloadProgressChangedEventArgs e);

abstract member OnDownloadProgressChanged : System.Net.DownloadProgressChangedEventArgs -> unit
override this.OnDownloadProgressChanged : System.Net.DownloadProgressChangedEventArgs -> unit

Protected Overridable Sub OnDownloadProgressChanged (e As DownloadProgressChangedEventArgs)

Параметры

e

DownloadProgressChangedEventArgs

Объект DownloadProgressChangedEventArgs, содержащий данные события.

Примеры

В следующем примере кода показана реализация этого метода, который можно настроить классом, производным от WebClient.

virtual void OnDownloadProgressChanged( DownloadProgressChangedEventArgs ^ e ) override
{
   // Here you can perform any custom actions before the event is raised
   // and event handlers are called...
   WebClient::OnDownloadProgressChanged( e );

   // Here you can perform any post event actions...
}

protected override void OnDownloadProgressChanged (DownloadProgressChangedEventArgs e)
{
    // Here you can perform any custom actions before the event is raised
    // and event handlers are called...

    base.OnDownloadProgressChanged (e);

    // Here you can perform any post event actions...
}

Комментарии

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

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

Классы, наследуемые от этого класса, могут переопределить этот метод для выполнения дополнительных задач при возникновении события DownloadProgressChanged.

При вызове события обработчик событий вызывается через делегат. Дополнительные сведения см. в обработке и вызове событий.

Метод OnDownloadProgressChanged также позволяет производным классам обрабатывать событие без присоединения делегата. Это предпочтительный способ обработки события в производном классе.

Примечания для тех, кто наследует этот метод

При переопределении OnDownloadProgressChanged(DownloadProgressChangedEventArgs) в производном классе обязательно вызовите метод OnDownloadProgressChanged(DownloadProgressChangedEventArgs) базового класса, чтобы зарегистрированные делегаты получали событие.