WebClient.OnDownloadStringCompleted(DownloadStringCompletedEventArgs) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Genera l'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)
Parametri
Oggetto DownloadStringCompletedEventArgs contenente i dati dell'evento.
Esempio
Nell'esempio di codice seguente viene illustrata un'implementazione di questo metodo che può essere personalizzata da una classe derivata da 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...
}
Commenti
Cautela
WebRequest
, HttpWebRequest
, ServicePoint
e WebClient
sono obsoleti e non è consigliabile usarli per nuovi sviluppi. Usare invece HttpClient.
Le classi che ereditano da questa classe possono eseguire l'override di questo metodo per eseguire attività aggiuntive quando si verifica l'evento DownloadStringCompleted.
La generazione di un evento richiama il gestore eventi tramite un delegato. Per altre informazioni, vedere gestione e generazione di eventi .
Il metodo OnDownloadStringCompleted consente anche alle classi derivate di gestire l'evento senza associare un delegato. Questa è la tecnica preferita per gestire l'evento in una classe derivata.
Note per gli eredi
Quando si esegue l'override di OnDownloadStringCompleted(DownloadStringCompletedEventArgs) in una classe derivata, assicurarsi di chiamare il metodo OnDownloadStringCompleted(DownloadStringCompletedEventArgs) della classe base in modo che i delegati registrati ricevano l'evento.