WebClient.OnDownloadStringCompleted(DownloadStringCompletedEventArgs) Método

Definição

Namespace:

System.Net

Assembly:

System.Net.WebClient.dll

Origem:

WebClient.cs

Gera o evento DownloadStringCompleted.

protected:
 virtual void OnDownloadStringCompleted(System::Net::DownloadStringCompletedEventArgs ^ e);

protected virtual void OnDownloadStringCompleted (System.Net.DownloadStringCompletedEventArgs e);

abstract member OnDownloadStringCompleted : System.Net.DownloadStringCompletedEventArgs -> unit
override this.OnDownloadStringCompleted : System.Net.DownloadStringCompletedEventArgs -> unit

Protected Overridable Sub OnDownloadStringCompleted (e As DownloadStringCompletedEventArgs)

Parâmetros

e

DownloadStringCompletedEventArgs

Um objeto DownloadStringCompletedEventArgs 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 OnDownloadStringCompleted( DownloadStringCompletedEventArgs ^ e ) override
{
   // Here you can perform any custom actions before the event is raised
   // and event handlers are called...
   WebClient::OnDownloadStringCompleted( e );

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

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

    base.OnDownloadStringCompleted (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 DownloadStringCompleted 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 OnDownloadStringCompleted 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 OnDownloadStringCompleted(DownloadStringCompletedEventArgs) em uma classe derivada, chame o método OnDownloadStringCompleted(DownloadStringCompletedEventArgs) da classe base para que os delegados registrados recebam o evento.