OnDownloadStringCompleted Method

WebClient.OnDownloadStringCompleted Method (DownloadStringCompletedEventArgs)


Raises the DownloadStringCompleted event.

Namespace:   System.Net
Assembly:  System (in System.dll)

protected virtual void OnDownloadStringCompleted(
	DownloadStringCompletedEventArgs e


Type: System.Net.DownloadStringCompletedEventArgs

A DownloadStringCompletedEventArgs object containing event data.

Classes that inherit from this class can override this method to perform additional tasks when the DownloadStringCompleted event occurs.

Raising an event invokes the event handler through a delegate. For more information, see NIB: Raising an Event.

The OnDownloadStringCompleted method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

Notes to Inheritors:

When overriding OnDownloadStringCompleted in a derived class, be sure to call the base class’s OnDownloadStringCompleted method so that registered delegates receive the event.

The following code example shows an implementation of this method that can be customized by a class derived from WebClient.

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...

.NET Framework
Available since 2.0
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Return to top
© 2015 Microsoft