WebClient.OnDownloadStringCompleted(DownloadStringCompletedEventArgs) Метод

Определение

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

System.Net

Сборка:

System.Net.WebClient.dll

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

WebClient.cs

Вызывает событие 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)

Параметры

e

DownloadStringCompletedEventArgs

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

Примеры

В следующем примере кода показана реализация этого метода, который можно настроить классом, производным от 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...
}

Комментарии

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

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

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

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

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

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

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