WebClient::OnDownloadFileCompleted Method (AsyncCompletedEventArgs^)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Raises the DownloadFileCompleted event.

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

virtual void OnDownloadFileCompleted(
	AsyncCompletedEventArgs^ e


Type: System.ComponentModel::AsyncCompletedEventArgs^

An AsyncCompletedEventArgs object containing event data.

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

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

The OnDownloadFileCompleted 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 OnDownloadFileCompleted in a derived class, be sure to call the base class’s OnDownloadFileCompleted 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.

virtual void OnDownloadFileCompleted( System::ComponentModel::AsyncCompletedEventArgs ^ e ) override
   // Here you can perform any custom actions before the event is raised
   // and event handlers are called...
   WebClient::OnDownloadFileCompleted( e );

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

.NET Framework
Available since 2.0
Return to top