DownloadProgressChangedEventHandler Delegat

Definicja

Namespace:

System.Net

Zestawów:

netstandard.dll, System.Net.WebClient.dll

Źródło:

WebClient.cs

Reprezentuje metodę, która obsłuży DownloadProgressChanged zdarzenie klasy WebClient.

public delegate void DownloadProgressChangedEventHandler(System::Object ^ sender, DownloadProgressChangedEventArgs ^ e);

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

type DownloadProgressChangedEventHandler = delegate of obj * DownloadProgressChangedEventArgs -> unit

Public Delegate Sub DownloadProgressChangedEventHandler(sender As Object, e As DownloadProgressChangedEventArgs)

Parametry

sender

Object

Źródło zdarzenia.

e

DownloadProgressChangedEventArgs

Zawierające DownloadProgressChangedEventArgs dane zdarzenia.

Przykłady

Poniższy przykład kodu przedstawia ustawienie procedury obsługi zdarzeń DownloadProgressChanged dla zdarzenia.

// 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);
}

' Sample call : DownLoadFileInBackground4 ("http://www.contoso.com/logs/January.txt");
Public Shared Sub DownLoadFileInBackground4(ByVal address As String)

    Dim client As WebClient = New WebClient()

    ' Specify a DownloadFileCompleted handler here...

    '  Specify a progress notification handler.
    AddHandler client.DownloadProgressChanged, AddressOf DownloadProgressCallback4

    Dim uri as Uri = New Uri(address)
    client.DownloadFileAsync(uri, "serverdata.txt")

End Sub

Private Shared Sub DownloadProgressCallback4(ByVal sender As Object, ByVal e As DownloadProgressChangedEventArgs)
    ' Displays the operation identifier, and the transfer progress.
    Console.WriteLine("{0}    downloaded {1} of {2} bytes. {3} % complete...", _
    CStr(e.UserState), e.BytesReceived, e.TotalBytesToReceive, e.ProgressPercentage)
End Sub

Uwagi

Podczas tworzenia delegata należy zidentyfikować metodę DownloadProgressChangedEventHandler , która będzie obsługiwać zdarzenie. Aby skojarzyć zdarzenie z programem obsługi zdarzeń, dodaj wystąpienie delegata do zdarzenia. Program obsługi zdarzeń jest wywoływany przy każdym wystąpieniu zdarzenia, o ile nie usunięto delegata. Aby uzyskać więcej informacji na temat delegatów programu obsługi zdarzeń, zobacz Obsługa i podnoszenie zdarzeń.

Uwaga

Jeśli serwer nie wysyła rozmiaru pobranego pliku (na przykład w przypadku pasywnego połączenia FTP), ProgressPercentage zawsze może być zerowy.

Metody rozszerzania

Nazwa	Opis
GetMethodInfo(Delegate)	Pobiera obiekt reprezentujący metodę reprezentowaną przez określonego delegata.