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 委派時，必須識別處理事件的方法。 若要使事件與您的事件處理常式產生關聯，請將委派的執行個體 (Instance) 加入至事件。 除非您移除委派，否則每當事件發生時就會呼叫事件處理常式。 如需事件處理程式委派的詳細資訊，請參閱 處理和引發事件。

注意

如果伺服器未傳送下載檔的大小 (，例如在被動 FTP 連線) 的情況下， ProgressPercentage 可能一律為零。

擴充方法

GetMethodInfo(Delegate)

取得表示特定委派所代表之方法的物件。

適用於