WebClient.DownloadProgressChanged 이벤트

정의

네임스페이스:

System.Net

어셈블리:

System.Net.WebClient.dll

Source:

WebClient.cs

비동기 다운로드 작업이 데이터의 일부 또는 전부를 성공적으로 전송할 때 발생합니다.

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

public event System.Net.DownloadProgressChangedEventHandler? DownloadProgressChanged;

member this.DownloadProgressChanged : System.Net.DownloadProgressChangedEventHandler 

Public Custom Event DownloadProgressChanged As DownloadProgressChangedEventHandler 

이벤트 유형

DownloadProgressChangedEventHandler

예제

다음 코드 예제에서는 DownloadProgressChanged 이벤트에 대 한 이벤트 처리기를 설정 하는 방법을 보여 줍니다.

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

설명

주의

WebRequest, HttpWebRequest, ServicePoint및 WebClient 사용되지 않으므로 새 개발에 사용하면 안 됩니다. 대신 HttpClient 사용합니다.

이 이벤트는 비동기 다운로드가 진행될 때마다 발생합니다. 이 이벤트는 다음 방법 중에서 다운로드를 시작할 때 발생합니다.

메서드	묘사
DownloadDataAsync	호출 스레드를 차단하지 않고 리소스에서 데이터를 다운로드하고 Byte 배열을 반환합니다.
DownloadFileAsync	호출 스레드를 차단하지 않고 리소스에서 로컬 파일로 데이터를 다운로드합니다.
OpenReadAsync	호출 스레드를 차단하지 않고 리소스에서 데이터를 반환합니다.

DownloadProgressChangedEventHandler 이 이벤트의 대리자입니다. DownloadProgressChangedEventArgs 클래스는 이벤트 처리기에 이벤트 데이터를 제공합니다.

이벤트를 처리하는 방법에 대한 자세한 내용은 이벤트 처리 및 발생참조하세요.

메모

수동 FTP 파일 전송은 서버가 파일 크기를 보내지 않았기 때문에 항상 진행률 0을 표시합니다. 진행률을 표시하려면 GetWebRequest(Uri) 가상 메서드를 재정의하여 FTP 연결을 활성으로 변경할 수 있습니다.

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