Click here to Skip to main content
14,239,882 members

SharpBITS.NET - A Wrapper for the BITS API

Rate this:
4.83 (22 votes)
Please Sign up or sign in to vote.
4.83 (22 votes)
7 Oct 2010CPOL
A BITS wrapper library for .NET 2.0.

Sharpbits.NET - Winforms application based on the wrapper library


SharpBITS is a library to wrap the BITS SDK for use with managed code on the .NET platform. It was intended and first implemented for a project designed to transfer large files over a slow and unstable WAN link. While there are some other options like use of FTP, BITS had some real advantages that made it the favorite selection.

As it uses the HTTP/HTTPS protocol to transfer files, it is immune to firewall restrictions. Also, it keeps a session (in default setting) for up to 14 days, which gives a reliable file transfer option in this case! The project where SharpBITS was developed consists of a small command line application, and the separate BITS wrapper library. Even if there are some custom implementations for the BITS wrapper available already, also for .NET managed code (see "Wrapping Bits" on MSDN), they are based on older versions of BITS and don't support some features like authentication, so the decision was to have a new C# based wrapper library.


Background Intelligent Transfer Service (BITS) can be used to transfer (large) files asynchronously between a client and a server. Background transfers are optimal in that BITS uses idle network bandwidth to transfer the files, and can increase or decrease the rate at which files are transferred based on the amount of idle network bandwidth available. If a network application begins to consume more bandwidth, BITS decreases its transfer rate to preserve the user's interactive experience. BITS continues to transfer files after an application exits if the user who initiated the transfer remains logged on and a network connection is maintained. BITS suspends the transfer if a connection is lost or if the user logs off. BITS persists transfer information while the user is logged off, across network disconnects, and during computer restarts.

The complete description and documentation on BITS can be found on MSDN.


For using BITS, the following requirements must be met:


On the client side, Windows 2000 SP3 or later is required and the BITS service must be running. BITS is also supported on Windows Vista and Longhorn Server (with upcoming new features like P2P-functionality).

Windows 95/98/ME/NT are not supported.


For uploads, BITS requires IIS 5.0 on Windows 2000 Server, and IIS 6.0 on Windows Server 2003 family; BITS does not support IIS 5.1 on Windows XP.

Using the code

All you have to do for getting started with SharpBITS is to create an instance of BitsManager. BitsManager is the single instance giving access to create a new job or list existing jobs.

To create a new job, the code looks as simple as that:

BitsManager manager = new BitsManager();

// populate current job list first
BitsJob job = manager.CreateJob("TestJob", JobType.Download);
job.AddFile("http://localhost/bits/", "C:\\temp\\");

Also, it is very simple to iterate through all existing jobs and list their properties. Each job has various properties like name, owner, priority, and of course, a list of files to transfer. (While a download job can have multiple files to transfer, an upload job is restricted to one file per job!)

// list either all jobs or for current user only
System.Console.WriteLine("Job Count for current user: {0}", 
foreach (BitsJob job in manager.Jobs.Values)
    System.Console.WriteLine("Displayname for job: {0}", job.DisplayName);
    System.Console.WriteLine("Owner: {0}", job.Owner);
    System.Console.WriteLine("Priority: {0}", job.Priority.ToString());
    System.Console.WriteLine("File Count for current job: {0}", 
    foreach (BitsFile file in job.Files)
        System.Console.WriteLine("Local File Name: {0}", file.LocalName);
        System.Console.WriteLine("Remote File Name: {0}", file.RemoteName);
        System.Console.WriteLine("Bytes total: {0}", 
        System.Console.WriteLine("Bytes transfered: {0}", 
    System.Console.WriteLine("Job State: {0}", job.State.ToString());
    System.Console.WriteLine("Job Type: {0}", job.JobType.ToString());

Instead of polling for the status of a job all the time, BITS enables to set a callback pointer for the notification interface. In SharpBITS, this callback handling is wrapped to .NET events. There are three different kinds of events, raised if job is modified, completed, or if an error has occurred. The JobModifiedEvent event will also be fired if the JobProgress or FileProgress for a job is updated, so this can be used to display a job progress.

Event handlers can be attached to either a job to get events for that particular job only, or to the BitsManager to catch all events. Even for those, you have to set the kind of events fired for each particular job.

//Set flags to get notified on Job Completed or Job Error event
job.NotificationFlags = 
    NotificationFlags.JobTransferred | NotificationFlags.JobErrorOccured;
//never raised with the previous flags
job.OnJobModifiedEvent += 
    new EventHandler<JOBNOTIFICATIONEVENTARGS>(job_OnJobModifiedEvent);


The interop handling in this library is based on some implementations from the "Microsoft Updater Application Block for .NET" (, which is part of the Enterprise Library.


As it seems, BITS can be used to fulfill various requirements for transferring files in a reliable manner, and is somewhat underestimated currently. I started to develop a Windows Forms application also (where the above screenshot was taken from). This application development is still in progress, but a running version and more details (source code as well) can be found on the SharpBITS.NET homepage.


  • 07/09/2006: Posted to CodeProject.
  • 10/10/2006: Update posted to CodeProject.


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


About the Author

Svalbard and Jan Mayen Svalbard and Jan Mayen
No Biography provided

Comments and Discussions

QuestionUsing like a service Pin
ErikIce5-Sep-11 6:39
memberErikIce5-Sep-11 6:39 
GeneralGreat wrapper and awesome support Pin
Stonkie10-Mar-11 10:14
memberStonkie10-Mar-11 10:14 
QuestionHow to upload file using credential in SharpBITS [modified] Pin
jep1tz4-Oct-10 19:01
memberjep1tz4-Oct-10 19:01 
AnswerRe: How to upload file using credential in SharpBITS Pin
xidar4-Oct-10 19:04
memberxidar4-Oct-10 19:04 
GeneralRe: How to upload file using credential in SharpBITS Pin
jep1tz4-Oct-10 22:22
memberjep1tz4-Oct-10 22:22 
GeneralWindows 7 x64 and VS2010 Debugger hang / program crash Pin
mikey2229-Jun-10 13:20
membermikey2229-Jun-10 13:20 
GeneralError when trying to user AddFile method Pin
Member 23755779-Apr-10 13:59
memberMember 23755779-Apr-10 13:59 
QuestionNew homepage for Sharpbits? Pin
BBiales3-Mar-09 6:49
memberBBiales3-Mar-09 6:49 
QuestionHow to 'Delete after upload complete' Pin
korggy30-Jan-09 19:13
memberkorggy30-Jan-09 19:13 
Questioncom visible? Pin
b002177521-Nov-08 2:59
memberb002177521-Nov-08 2:59 
AnswerRe: com visible? Pin
xidar24-Nov-08 4:33
memberxidar24-Nov-08 4:33 
QuestionUrgent: use sharp bits in windows service Pin
Mavei3-Nov-08 19:41
memberMavei3-Nov-08 19:41 
AnswerRe: Urgent: use sharp bits in windows service Pin
xidar3-Nov-08 22:23
memberxidar3-Nov-08 22:23 
GeneralRe: Urgent: use sharp bits in windows service Pin
Mavei3-Nov-08 23:20
memberMavei3-Nov-08 23:20 
GeneralRe: Urgent: use sharp bits in windows service Pin
BBiales3-Mar-09 6:32
memberBBiales3-Mar-09 6:32 
GeneralRe: Urgent: use sharp bits in windows service Pin
Depthi26-Jun-13 3:03
memberDepthi26-Jun-13 3:03 
QuestionHow Upload? Pin
rbarzallo31-Oct-08 13:47
memberrbarzallo31-Oct-08 13:47 
AnswerRe: How Upload? Pin
xidar3-Nov-08 22:24
memberxidar3-Nov-08 22:24 
QuestionGet Job ID from OnJobCompleted? Pin
NiteBeast18-Sep-08 12:48
memberNiteBeast18-Sep-08 12:48 
AnswerRe: Get Job ID from OnJobCompleted? Pin
xidar18-Sep-08 20:38
memberxidar18-Sep-08 20:38 
QuestionRe: Get Job ID from OnJobCompleted? [modified] Pin
NiteBeast19-Sep-08 4:45
memberNiteBeast19-Sep-08 4:45 
QuestionResume download from web client. Pin
dotnetgoodman17-Jun-08 2:18
memberdotnetgoodman17-Jun-08 2:18 
AnswerRe: Resume download from web client. Pin
xidar17-Jun-08 4:09
memberxidar17-Jun-08 4:09 
GeneralBITS Server configuration Pin
Vincent DUVERNET (Nolmë Informatique)20-May-08 12:40
memberVincent DUVERNET (Nolmë Informatique)20-May-08 12:40 
Generalworking with bits over web application [modified] Pin
cmartinez34521-Nov-07 11:51
membercmartinez34521-Nov-07 11:51 

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

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

Posted 9 Jul 2006


136 bookmarked