DownloadProgressChangedEventHandler 委托

定义

命名空间:

System.Net

程序集:

netstandard.dll, System.Net.WebClient.dll

表示将用来处理 DownloadProgressChanged 的 WebClient 事件的方法。

C#

public delegate void DownloadProgressChangedEventHandler(object sender, DownloadProgressChangedEventArgs e);

参数

sender

Object

事件源。

e

DownloadProgressChangedEventArgs

一个包含事件数据的 DownloadProgressChangedEventArgs。

示例

下面的代码示例演示如何为 DownloadProgressChanged 事件设置事件处理程序。

C#

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

    // Specify a DownloadFileCompleted handler here...

    // Specify a progress notification handler.
    client.DownloadProgressChanged += new DownloadProgressChangedEventHandler(DownloadProgressCallback4);

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

private static void DownloadProgressCallback4(object sender, DownloadProgressChangedEventArgs e)
{
    // Displays the operation identifier, and the transfer progress.
    Console.WriteLine("{0}    downloaded {1} of {2} bytes. {3} % complete...",
        (string)e.UserState,
        e.BytesReceived,
        e.TotalBytesToReceive,
        e.ProgressPercentage);
}

注解

创建 DownloadProgressChangedEventHandler 委托时，需要标识将处理该事件的方法。 若要将事件与事件处理程序关联，请将该委托的一个实例添加到事件中。 除非移除了该委托，否则每当发生该事件时就会调用事件处理程序。 有关事件处理程序委托的详细信息，请参阅 处理和引发事件。

备注

如果服务器不发送下载的文件的大小 (例如，在被动 FTP 连接) 的情况下， ProgressPercentage 可能始终为零。

扩展方法

GetMethodInfo(Delegate)

获取指示指定委托表示的方法的对象。

适用于