DownloadProgressChangedEventArgs Class
Provides data for the DownloadProgressChanged event of a WebClient.
Assembly: System (in System.dll)
System::EventArgs
System.ComponentModel::ProgressChangedEventArgs
System.Net::DownloadProgressChangedEventArgs
| Name | Description | |
|---|---|---|
![]() | BytesReceived | Gets the number of bytes received. |
![]() | ProgressPercentage | Gets the asynchronous task progress percentage.(Inherited from ProgressChangedEventArgs.) |
![]() | TotalBytesToReceive | Gets the total number of bytes in a WebClient data download operation. |
![]() | UserState | Gets a unique user state.(Inherited from ProgressChangedEventArgs.) |
| Name | Description | |
|---|---|---|
![]() | Equals(Object^) | Determines whether the specified object is equal to the current object.(Inherited from Object.) |
![]() | Finalize() | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.) |
![]() | GetHashCode() | Serves as the default hash function. (Inherited from Object.) |
![]() | GetType() | |
![]() | MemberwiseClone() | |
![]() | ToString() | Returns a string that represents the current object.(Inherited from Object.) |
Instances of this class are passed to the DownloadProgressChangedEventHandler.
The following code example demonstrates setting an event handler for the DownloadProgressChanged event.
// Sample call : DownLoadFileInBackground2 ("http://www.contoso.com/logs/January.txt"); void DownLoadFileInBackground2( String^ address ) { WebClient^ client = gcnew WebClient; Uri ^uri = gcnew Uri(address); // Specify that the DownloadFileCallback method gets called // when the download completes. client->DownloadFileCompleted += gcnew AsyncCompletedEventHandler( DownloadFileCallback2 ); // Specify a progress notification handler. client->DownloadProgressChanged += gcnew DownloadProgressChangedEventHandler( DownloadProgressCallback ); client->DownloadFileAsync( uri, "serverdata.txt" ); }
The following code example shows an implementation of a handler for this event.
static void UploadProgressCallback(Object^ sender, UploadProgressChangedEventArgs^ e) { // Displays the operation identifier, and the transfer progress. Console::WriteLine("{0} uploaded {1} of {2} bytes. {3} % complete...", (String ^)e->UserState, e->BytesSent, e->TotalBytesToSend, e->ProgressPercentage); } static void DownloadProgressCallback(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); }
Available since 2.0
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.


