WebClient.DownloadProgressChanged Událost

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.WebClient.dll

Zdroj:

WebClient.cs

Nastane, když asynchronní operace stahování úspěšně přenese některá nebo všechna data.

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

public event System.Net.DownloadProgressChangedEventHandler? DownloadProgressChanged;

member this.DownloadProgressChanged : System.Net.DownloadProgressChangedEventHandler 

Public Custom Event DownloadProgressChanged As DownloadProgressChangedEventHandler 

Event Type

DownloadProgressChangedEventHandler

Příklady

Následující příklad kódu ukazuje nastavení obslužné rutiny DownloadProgressChanged události pro událost.

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

Poznámky

Tato událost je vyvolána pokaždé, když asynchronní stahování pokračuje. Tato událost je vyvolána při spuštění stahování pomocí některé z následujících metod.

Metoda	Popis
DownloadDataAsync	Stáhne data z prostředku a vrátí Byte pole bez blokování volajícího vlákna.
DownloadFileAsync	Stáhne data z prostředku do místního souboru bez blokování volajícího vlákna.
OpenReadAsync	Vrátí data z prostředku bez blokování volajícího vlákna.

Je DownloadProgressChangedEventHandler delegátem této události. Třída DownloadProgressChangedEventArgs poskytuje obslužné rutině události data události.

Další informace o zpracování událostí najdete v tématu Zpracování a vyvolávání událostí.

Poznámka

Pasivní přenos souborů FTP bude vždy zobrazovat procento průběhu nula, protože server neodeslal velikost souboru. Pokud chcete zobrazit průběh, můžete změnit připojení FTP na aktivní přepsáním GetWebRequest(Uri) virtuální metody:

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