WebClient.DownloadFileCompleted Event

Definition

Namespace:

System.Net

Assemblies:

netstandard.dll, System.Net.WebClient.dll

Source:

WebClient.cs

Occurs when an asynchronous file download operation completes.

C#

public event System.ComponentModel.AsyncCompletedEventHandler? DownloadFileCompleted;

Event Type

AsyncCompletedEventHandler

Examples

The following code example demonstrates setting an event handler for the DownloadFileCompleted event.

C#

// Sample call : DownLoadFileInBackground2 ("http://www.contoso.com/logs/January.txt");
public static void DownLoadFileInBackground2(string address)
{
    WebClient client = new WebClient();
    Uri uri = new Uri(address);

    // Call DownloadFileCallback2 when the download completes.
    client.DownloadFileCompleted += new AsyncCompletedEventHandler(DownloadFileCallback2);

    // Specify a progress notification handler here ...

    client.DownloadFileAsync(uri, "serverdata.txt");
}

private static void DownloadFileCallback2(object sender, AsyncCompletedEventArgs e)
{
    if (e.Cancelled)
    {
        Console.WriteLine("File download cancelled.");
    }

    if (e.Error != null)
    {
        Console.WriteLine(e.Error.ToString());
    }
}

Remarks

Caution

WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete, and you shouldn't use them for new development. Use HttpClient instead.

This event is raised each time an asynchronous file download operation completes. Asynchronous file downloads are started by calling the DownloadFileAsync methods.

The AsyncCompletedEventHandler is the delegate for this event. The AsyncCompletedEventArgs class provides the event handler with event data.

For more information about how to handle events, see Handling and Raising Events.

Applies to