WebClient.DownloadProgressChanged Olay

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

System.Net.WebClient.dll

Kaynak:

WebClient.cs

Zaman uyumsuz bir indirme işlemi verilerin bir kısmını veya tamamını başarıyla aktardığında gerçekleşir.

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

public event System.Net.DownloadProgressChangedEventHandler? DownloadProgressChanged;

member this.DownloadProgressChanged : System.Net.DownloadProgressChangedEventHandler 

Public Custom Event DownloadProgressChanged As DownloadProgressChangedEventHandler 

Olay Türü

DownloadProgressChangedEventHandler

Örnekler

Aşağıdaki kod örneği, olay için bir olay işleyicisi ayarlamayı DownloadProgressChanged gösterir.

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

Açıklamalar

Bu olay, zaman uyumsuz bir indirme işlemi her ilerleme kaydettiğinde oluşturulur. Bu olay, indirmeler aşağıdaki yöntemlerden herhangi biri kullanılarak başlatıldığında tetiklenir.

Yöntem	Açıklama
DownloadDataAsync	Bir kaynaktan veri indirir ve çağıran iş parçacığını engellemeden bir Byte dizi döndürür.
DownloadFileAsync	Çağıran iş parçacığını engellemeden verileri bir kaynaktan yerel bir dosyaya indirir.
OpenReadAsync	Çağıran iş parçacığını engellemeden bir kaynaktan verileri döndürür.

DownloadProgressChangedEventHandler, bu olayın temsilcisidir. sınıfı, DownloadProgressChangedEventArgs olay işleyicisine olay verilerini sağlar.

Olayları işleme hakkında daha fazla bilgi için bkz. Olayları İşleme ve Oluşturma.

Not

Pasif FTP dosya aktarımı, sunucu dosya boyutunu göndermediğinden her zaman sıfır ilerleme yüzdesi gösterir. İlerleme durumunu göstermek için sanal yöntemi geçersiz kılarak FTP bağlantısını etkin olarak GetWebRequest(Uri) değiştirebilirsiniz:

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