WebClient.DownloadProgressChanged Zdarzenie

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebClient.dll

Zestaw:

System.dll

Zestaw:

netstandard.dll

Występuje, gdy operacja pobierania asynchronicznego pomyślnie przenosi niektóre lub wszystkie dane.

public:
 event System::Net::DownloadProgressChangedEventHandler ^ DownloadProgressChanged;

public event System.Net.DownloadProgressChangedEventHandler? DownloadProgressChanged;

public event System.Net.DownloadProgressChangedEventHandler DownloadProgressChanged;

member this.DownloadProgressChanged : System.Net.DownloadProgressChangedEventHandler 

Public Custom Event DownloadProgressChanged As DownloadProgressChangedEventHandler 

Public Event DownloadProgressChanged As DownloadProgressChangedEventHandler 

Typ zdarzenia

DownloadProgressChangedEventHandler

Przykłady

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

// Sample call : DownLoadFileInBackground4 ("http://www.contoso.com/logs/January.txt");
void DownLoadFileInBackground4( String^ address )
{
   WebClient^ client = gcnew WebClient;
   Uri ^uri = gcnew Uri(address);

   // Specify a DownloadFileCompleted handler here...

   // Specify a progress notification handler.
   client->DownloadProgressChanged += gcnew DownloadProgressChangedEventHandler( DownloadProgressCallback4 );
   
   client->DownloadFileAsync( uri, "serverdata.txt" );
}

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 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

To zdarzenie jest wywoływane za każdym razem, gdy pobieranie asynchroniczne powoduje postęp. To zdarzenie jest wywoływane po rozpoczęciu pobierania przy użyciu dowolnej z poniższych metod.

Metoda	Opis
DownloadDataAsync	Pobiera dane z zasobu i zwraca tablicę Byte bez blokowania wątku wywołującego.
DownloadFileAsync	Pobiera dane z zasobu do pliku lokalnego bez blokowania wątku wywołującego.
OpenReadAsync	Zwraca dane z zasobu bez blokowania wątku wywołującego.

Element DownloadProgressChangedEventHandler jest pełnomocnikem dla tego zdarzenia. Klasa DownloadProgressChangedEventArgs udostępnia procedurę obsługi zdarzeń z danymi zdarzenia.

Aby uzyskać więcej informacji na temat obsługi zdarzeń, zobacz Obsługa i podnoszenie zdarzeń.

Uwaga

Pasywny transfer plików FTP zawsze będzie pokazywać procent postępu zera, ponieważ serwer nie wysłał rozmiaru pliku. Aby pokazać postęp, możesz zmienić połączenie FTP na aktywne, przesłaniając metodę wirtualną GetWebRequest(Uri) :

internal class MyWebClient : WebClientProtocol
{
    protected override WebRequest GetWebRequest(Uri address)
    {
        FtpWebRequest req = (FtpWebRequest)base.GetWebRequest(address);
        req.UsePassive = false;
        return req;
    }
}