Click here to Skip to main content
11,799,282 members (71,685 online)
Click here to Skip to main content

C# .NET Background File Downloader

, 2 May 2009 GPL3 67.7K 8.7K 101
Rate this:
Please Sign up or sign in to vote.
A multithreaded file downloader with progress details, speed info and more


This class enables you to easily download multiple files in the background (via a separate thread), and will provide information about the amount of downloaded data, the percentage of completion, and the download speed. On top of this, you can cancel downloading, pause it, and of course, also resume.


I started working on this class after someone on a programming help forum asked how to best download files in the background. I originally wrote it in VB.NET, but have now created a C# implementation. Check the VB.NET Background File Downloader article for the original code. Another difference with the original VB.NET implementation is that this code uses a WPF demo application, and not a Windows Forms based one.

Using the Code

Once you added the class to your project, you should be able to access it via the project's namespace .

The first thing you need to do when using this class is (logically) create a new instance, and then add the files you want to download. You'll also need to set the local directory to which you want to download. This is pretty straight forward.

// Creating a new instance of a FileDownloader
private FileDownloader downloader = new FileDownloader();

You'll also want to add some files to the list that need to be downloaded. This example demonstrates how to read each line of a WPF RichTextBox and add it to the list:

// A simple implementation of setting the directory path, 
// adding files from a textbox and starting the download
private void btnStart_Click(object sender, RoutedEventArgs e)
    System.Windows.Forms.FolderBrowserDialog openFolderDialog = 
			new System.Windows.Forms.FolderBrowserDialog();
     if (openFolderDialog.ShowDialog() == System.Windows.Forms.DialogResult.OK)
        // Set the path to the local directory where the files will be downloaded to
        downloader.LocalDirectory = openFolderDialog.SelectedPath;
         // Clear the current list of files (in case it's not the first download)
         // Get the contents of the rich text box
        string rtbContents = new TextRange(rtbPaths.Document.ContentStart, 
        foreach (string line in rtbContents.Split('\n'))
            String trimmedLine = line.Trim(' ', '\r');
            if (trimmedLine.Length > 0)
                // If the line is not empty, assume it's a valid URL 
	       // and add it to the files list
                // Note: You could check if the URL is valid before adding it, 
	       // and probably should do this is a real application
                downloader.Files.Add(new FileDownloader.FileInfo(trimmedLine));
         // Start the downloader

Note: The example code in this article is for a C# WPF application, and will be slightly different for a C# forms application.

The code needed to then pause, resume or cancel the downloads couldn't be simpler:

private void btnPause_Click(object sender, RoutedEventArgs e)
    // Pause the downloader
private void btnResume_Click(object sender, RoutedEventArgs e)
    // Resume the downloader
private void btnStop_Click(object sender, RoutedEventArgs e)
    // Stop the downloader
    // Note: This will not be instantaneous - the current requests need to be 
    // closed down, and the downloaded files need to be deleted

The downloader also provides a few properties to indicate its current state: IsBusy, IsPaused, CanStart, CanStop, CanPause and CanResume (all booleans). Here you have an example of how to use these to set your interface:

// This event is fired every time the paused or busy state is changed, 
// and used here to set the controls of the interface
// This makes it equivalent to a void handling both 
// downloader.IsBusyChanged and downloader.IsPausedChanged
private void downloader_StateChanged(object sender, EventArgs e)
    // Setting the buttons
    btnStart.IsEnabled = downloader.CanStart;
    btnStop.IsEnabled = downloader.CanStop;
    btnPause.IsEnabled = downloader.CanPause;
    btnResume.IsEnabled = downloader.CanResume;
     // Enabling or disabling the setting controls
    rtbPaths.IsReadOnly = downloader.IsBusy;
    cbUseProgress.IsEnabled = !downloader.IsBusy;

This is the demo code to display the progress information:

// Occurs every time of block of data has been downloaded, 
// and can be used to display the progress with
// Note that you can also create a timer, 
// and display the progress every certain interval
// Also note that the progress properties return a size in bytes, 
// which is not really user friendly to display
// The FileDownloader class provides static functions to format 
// these byte amounts to a more readable format, either in binary or decimal notation 
private void downloader_ProgressChanged(object sender, EventArgs e)
    pBarFileProgress.Value = downloader.CurrentFilePercentage();
    lblFileProgress.Content = String.Format("Downloaded {0} of {1} ({2}%)", 
		downloader.CurrentFilePercentage()) + String.Format(" - {0}/s", 
    if (downloader.SupportsProgress)
        pBarTotalProgress.Value = downloader.TotalPercentage();
        lblTotalProgress.Content = String.Format("Downloaded {0} of {1} ({2}%)", 

Another noteworthy snippet of code is how to set the SupportsProgress property.

// Setting the SupportsProgress property - if set to false, 
// no total progress data will be available!
private void cbUseProgress_Checked(object sender, RoutedEventArgs e)
    downloader.SupportsProgress = (Boolean)cbUseProgress.IsChecked; 

When the SupportProgress property is set to true, the file sizes will be calculated before any download is started. This can take a while, definitely when you have a large amount of files. The FileDownloader class fires an event every time it starts checking the size of a file, which can be used to display the progress.

// Show the progress of file size calculation
// Note that these events will only occur when the total file size is 
// calculated in advance, in other words when the SupportsProgress is set to true
private void downloader_CalculationFileSize(object sender, Int32 fileNr)
    lblStatus.Content = String.Format("Calculating file sizes - 
			file {0} of {1}", fileNr, downloader.Files.Count);


Points of Interest

The main reasons for translating my VB.NET class to C# were to both fully familiarize myself with C#, and its differences compared to VB.NET, and to exercise some WPF basics.

I'm hoping to implement some more features soon, including cancellation without deleting the files and the option to resume downloading afterwards, and the ability to download multiple files simultaneously, on separate threads.


  • May 2nd 2009: Published the C# class and this article
  • April 22nd 2009: Published an article about the VB.NET class
  • April 21st 2009: Published the VB.NET class
    • For the code the original VB.NET class is based upon (can be seen as an older version), see this article.


  • Dutch support for this class can be found here.


This article, along with any associated source code and files, is licensed under The GNU General Public License (GPLv3)


About the Author

Jeroen De Dauw
Software Developer
Belgium Belgium
I am a free and open source software enthusiast and freelance software developer with multiple years of experience in both web and desktop development. Currently my primarily focus is on MediaWiki and Semantic MediaWiki work. I'm in the all time top 10 MediaWiki comitters and am one of the WikiWorks consultants. You can contact me at jeroendedauw at gmail for development jobs and questions related to my work.

More info can be found on my website [0] and my blog [1]. You can also follow me on twitter [2] and [3].


You may also be interested in...

Comments and Discussions

QuestionNeed some info Pin
Tridip Bhattacharjee27-Mar-13 8:03
memberTridip Bhattacharjee27-Mar-13 8:03 
SuggestionFile In Use Exception Pin
wannabeuk11-Dec-12 3:55
memberwannabeuk11-Dec-12 3:55 
Questionwin 7 64-bit freezes Pin
Noel Buenaventura2-Dec-12 8:27
memberNoel Buenaventura2-Dec-12 8:27 
Questiondownloader class Pin
eranotz5017-Nov-12 5:46
membereranotz5017-Nov-12 5:46 
Questionhow to auto connect with internt Url Pin
manojmadhur28-Apr-12 10:20
membermanojmadhur28-Apr-12 10:20 
GeneralGood work Pin
jirikadlec230-May-11 10:41
memberjirikadlec230-May-11 10:41 
GeneralDoes not work. Pin
iJam_j6-Feb-11 22:22
memberiJam_j6-Feb-11 22:22 
GeneralRe: Does not work. Pin
Jeroen De Dauw7-Feb-11 5:49
memberJeroen De Dauw7-Feb-11 5:49 
GeneralRe: Does not work. Pin
iJam_j7-Feb-11 19:20
memberiJam_j7-Feb-11 19:20 
GeneralAdded support for more complex urls [modified] Pin
QRoX29-Jun-10 11:38
memberQRoX29-Jun-10 11:38 
GeneralA little improvement / bug fix Pin
QRoX29-Jun-10 8:14
memberQRoX29-Jun-10 8:14 
GeneralFTP Enhancement Pin
Mustafa Tümer TAN25-Apr-10 0:42
memberMustafa Tümer TAN25-Apr-10 0:42 
GeneralUnable to read data from the transport connection: The connection was closed Pin
Izisin26-Mar-10 13:54
memberIzisin26-Mar-10 13:54 
GeneralRe: Unable to read data from the transport connection: The connection was closed Pin
jeroen de dauw26-Mar-10 19:04
memberjeroen de dauw26-Mar-10 19:04 
GeneralRe: Unable to read data from the transport connection: The connection was closed Pin
swaby21-Mar-12 17:06
memberswaby21-Mar-12 17:06 
GeneralThanks for the article. Pin
oddessa3714-Jan-10 0:34
memberoddessa3714-Jan-10 0:34 
GeneralRe: Thanks for the article. Pin
jeroen de dauw14-Jan-10 1:30
memberjeroen de dauw14-Jan-10 1:30 
QuestionRe: Thanks for the article. [modified] Pin
oddessa3714-Jan-10 4:12
memberoddessa3714-Jan-10 4:12 
Generalexception Pin
malac13-Jul-09 2:16
membermalac13-Jul-09 2:16 
GeneralRe: exception Pin
bn2vs14-Jul-09 12:29
memberbn2vs14-Jul-09 12:29 
QuestionDownload HTML file from web? Pin
Microtoby29-Jun-09 7:53
memberMicrotoby29-Jun-09 7:53 
AnswerRe: Download HTML file from web? Pin
bn2vs14-Jul-09 12:31
memberbn2vs14-Jul-09 12:31 
GeneralRe: Download HTML file from web? Pin
Microtoby15-Jul-09 22:53
memberMicrotoby15-Jul-09 22:53 
GeneralRe: Download HTML file from web? Pin
bn2vs17-Jul-09 9:07
memberbn2vs17-Jul-09 9:07 
QuestionWhy not use BITS? Pin
Soundman32.24-May-09 21:26
memberSoundman32.24-May-09 21:26 
AnswerRe: Why not use BITS? Pin
bn2vs4-May-09 21:37
memberbn2vs4-May-09 21:37 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web01 | 2.8.151002.1 | Last Updated 2 May 2009
Article Copyright 2009 by Jeroen De Dauw
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid