Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
TotalBytesToReceive Property
Collapse the table of content
Expand the table of content

DownloadProgressChangedEventArgs.TotalBytesToReceive Property

Note: This property is new in the .NET Framework version 2.0.

Gets the total number of bytes in a WebClient data download operation.

Namespace: System.Net
Assembly: System (in system.dll)

public long TotalBytesToReceive { get; }
/** @property */
public long get_TotalBytesToReceive ()

public function get TotalBytesToReceive () : long

Property Value

An Int64 value that indicates the number of bytes that will be received.

To determine the number of bytes already received, use the BytesReceived property.

To determine what percentage of the transfer has occurred, use the ProgressPercentage property.

The following code example shows an implementation of a handler for the DownloadProgressChanged event. The method displays the value of this property.

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);
}

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0

Community Additions

ADD
Show:
© 2015 Microsoft