WebClient.OnDownloadStringCompleted(DownloadStringCompletedEventArgs) Método

Definição

Aciona 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 DownloadStringCompletedEventArgs objeto 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

Caution

WebRequest, HttpWebRequeste ServicePointWebClient são obsoletos e você não deve usá-los para um novo desenvolvimento. Use HttpClient em seu lugar.

Classes que herdam dessa classe podem substituir esse método para executar tarefas adicionais quando o DownloadStringCompleted evento 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 OnDownloadStringCompleted método 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, certifique-se de chamar o método da classe base OnDownloadStringCompleted(DownloadStringCompletedEventArgs) para que os delegados registrados recebam o evento.

Aplica-se a