WebClient.OnDownloadProgressChanged(DownloadProgressChangedEventArgs) Método

Definição

Namespace:

System.Net

Assembly:

System.Net.WebClient.dll

Origem:

WebClient.cs

Gera o evento 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)

Parâmetros

e

DownloadProgressChangedEventArgs

Um objeto DownloadProgressChangedEventArgs que contém dados de evento.

Exemplos

O exemplo de código a seguir mostra uma implementação desse método que pode ser personalizada por uma classe derivada de 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...
}

Comentários

Cuidado

WebRequest, HttpWebRequest, ServicePointe WebClient estão obsoletos e você não deve usá-los para um novo desenvolvimento. Em vez disso, use HttpClient.

Classes que herdam dessa classe podem substituir esse método para executar tarefas adicionais quando o evento DownloadProgressChanged ocorrer.

A criação de um evento invoca o manipulador de eventos por meio de um delegado. Para obter mais informações, consulte manipulação e geração de eventos.

O método OnDownloadProgressChanged também permite que classes derivadas manipulem o evento sem anexar um delegado. Essa é a técnica preferencial para lidar com o evento em uma classe derivada.

Notas aos Herdeiros

Ao substituir OnDownloadProgressChanged(DownloadProgressChangedEventArgs) em uma classe derivada, chame o método OnDownloadProgressChanged(DownloadProgressChangedEventArgs) da classe base para que os delegados registrados recebam o evento.