WebClient::DownloadStringCompleted Event


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

Occurs when an asynchronous resource-download operation completes.

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

event DownloadStringCompletedEventHandler^ DownloadStringCompleted {
	void add(DownloadStringCompletedEventHandler^ value);
	void remove(DownloadStringCompletedEventHandler^ value);

This event is raised each time an asynchronous operation to download a resource as a string completes. These operations are started by calling the DownloadStringAsync methods.

The DownloadStringCompletedEventHandler is the delegate for this event. The DownloadStringCompletedEventArgs class provides the event handler with event data.

For more information about handling events, see NIB: Consuming Events.

The following code example demonstrates setting an event handler for this event.

// Sample call : DownloadStringInBackground2 ("http://www.contoso.com/GameScores.html");
void DownloadStringInBackground2( String^ address )
   WebClient^ client = gcnew WebClient;
   Uri ^uri = gcnew Uri(address);

   // Specify that the DownloadStringCallback2 method gets called
   // when the download completes.
   client->DownloadStringCompleted += gcnew DownloadStringCompletedEventHandler( DownloadStringCallback2 );
   client->DownloadStringAsync( uri );

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