Click here to Skip to main content
13,794,530 members
Click here to Skip to main content
Add your own
alternative version


28 bookmarked
Posted 7 Dec 2004
Licenced CPOL

Pushing HTML content to a Blackberry

, 7 Dec 2004
Rate this:
Please Sign up or sign in to vote.
How to push HTML content to a blackberry handheld using MDS

Blackberry showing pushed HTML content

<!------------------------------- STEP 3 ---------------------------><!-- Add the article text. Please use simple formatting (


etc) -->


Blackberry's (developed by Research In Motion - RIM) have become a critical part of many corporate networks including IT, financial and government networks.  Their always connected nature and rich content delivery services (through Blackberry Enterprise Server and Mobile Data Service) make them very inviting to developers to develop applications for.  Out of the box, you can deliver HTML content to them with very little work.  Their Java-based operating system allows for developers to create applications that deliver data in real time and can be interacted with using the devices intuitive user interface and full QWERTY keyboard.

I am going to concentrate on the most simplistic way to delivery content to the device using a HTML browser channel.   My next article may include a custom application for the handheld.

In order to use this code you need

  1. A Blackberry Enterprise Server 4.0 or above
  2. A Blackberry handheld running the 4.0 operating system or above
  3. The IPPP service book installed (automatically installed through Enterprise Activation)
  4. IIS 5 or above to run the WebService I have created

How It Works

The Mobile Data Service is completely HTTP based. You establish an HTTP connection to your Blackberry Enterprise Server (default port is 8300) with some query parameters and POST containing your data.  The handheld's browser listens on port 7874 for incoming pushes.  Custom Blackberry HTTP headers specify information about the content and how to display it (including read and unread icons, title, etc).  For simplicity sakes, I am going to let the handheld use its default icons. 

Using the code

I decided to implement this as a WebService to allow for easy access from other internal applications.  The code is pretty straight forward.  There is one WebService method and one protected method that handles actually creating the HTTP request and firing it off to the MDS server. Configuration information about the MDS server is held in web.config and can be accessed using the built in ConfigurationSettings.AppSettings collection.

The WebService method has the following signature:

public virtual void PushToBrowser(string[] recipients, <BR>                                  string channelTitle, <BR>                                  string channelName, <BR>                                  string baseLocation, <BR>                                  string message)

To use, create a new application, add a web reference to it (I called mine BesUtils).  The code below illustrates how you'd push a simple HTML document to a handheld

BesUtils.MdsPusher pusher = new BesUtils.MdsPusher();

string[] recip = {""};

    pusher.PushToBrowser(recip, "Hello World", Guid.NewGuid().ToString(), <BR>               "", "<html><head></head><body>Hello World.</body></html>");
catch(Exception ex)

The image at the top of this article illustrates the icon and text that appears when a new message has been pushed to the handheld. You would click the icon to open the browser and it would take you directly to the document you pushed down.

Points of Interest

You need to keep channelName constant if you want the handheld to update the same channel, otherwise a new channel will be created each time you push to the handheld.


  • December 7, 2004 - First version of article published,


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


About the Author

Steven Berkovitz
Web Developer
Canada Canada
Steven is VP Development at MBC Computer Solutions Ltd. (, a Richmond Hill based company specializing in e-Business Application Development, e-Store Solutions, Managed Co-Location and Proactive IT services.

Steven has over 10 years experience in software and hardware design and is experienced with a large array of platforms, technologies and languages.

In his spare time, Steven enjoys a wide array of music, is an avid skier and enjoys spending time with friends.

Steven is the primary contributor of MBC's blog which can be read at

You may also be interested in...


Comments and Discussions

Questioni want send message to blackberry from windows desktop application Pin
sriram30308-Aug-07 20:20
membersriram30308-Aug-07 20:20 
GeneralBES Server Setting Pin
SubraS24-May-06 10:40
memberSubraS24-May-06 10:40 
GeneralRe: BES Server Setting Pin
Steven Berkovitz24-May-06 10:56
memberSteven Berkovitz24-May-06 10:56 
GeneralRe: BES Server Setting Pin
SubraS24-May-06 11:02
memberSubraS24-May-06 11:02 
GeneralRe: BES Server Setting Pin
Steven Berkovitz24-May-06 11:03
memberSteven Berkovitz24-May-06 11:03 
GeneralRe: BES Server Setting Pin
SubraS24-May-06 11:32
memberSubraS24-May-06 11:32 
QuestionHow to Remove newly created channels Pin
drex300022-Feb-06 6:48
memberdrex300022-Feb-06 6:48 
AnswerRe: How to Remove newly created channels Pin
Steven Berkovitz22-Feb-06 12:27
memberSteven Berkovitz22-Feb-06 12:27 
I'm glad this has been useful for you.

To remove channels, open your browser (on your handheld), and in the bookmarks section there is a new Node called "Browser Channels". You can remove the channels from here.



GeneralRe: How to Remove newly created channels Pin
drex300023-Feb-06 6:44
memberdrex300023-Feb-06 6:44 
GeneralRe: How to Remove newly created channels Pin
Steven Berkovitz23-Feb-06 6:46
memberSteven Berkovitz23-Feb-06 6:46 
GeneralGET Data Pin
cberam4-May-05 20:12
membercberam4-May-05 20:12 
GeneralFYI - download the simulator Pin
Anonymous15-Dec-04 4:11
memberAnonymous15-Dec-04 4:11 
GeneralRe: FYI - download the simulator Pin
Steven Berkovitz15-Dec-04 6:40
memberSteven Berkovitz15-Dec-04 6:40 

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.

Permalink | Advertise | Privacy | Cookies | Terms of Use | Mobile
Web05 | 2.8.181207.3 | Last Updated 7 Dec 2004
Article Copyright 2004 by Steven Berkovitz
Everything else Copyright © CodeProject, 1999-2018
Layout: fixed | fluid