Click here to Skip to main content
15,306,017 members
Articles / Web Development / ASP.NET
Posted 24 Jul 2006


41 bookmarked

Configuring .Net 2.0 to recognise the BlackBerry browser

Rate me:
Please Sign up or sign in to vote.
4.68/5 (14 votes)
24 Jul 2006CPOL3 min read
Version 2.0 of the .Net framework does not ship with a configuration file for the Blackberry browser, this article will show how to set one up.


While writing ASP.NET applications targeting the BlackBerry browser I have made some interesting discoveries. In this article I will show how to configure .NET 2.0 to recognise the BlackBerry browser so that it behaves as you would expect.


I have developed several ASP.NET 1.1 applications targeting the BlackBerry browser version 4.1 on the 7290 device and more recently the 8700g. I have been upgrading those projects to ASP.NET 2.0 and was quite baffled initially, when several features would just not work.

Creating a BlackBerry.browser config file

After a quick look through the \WINDOWS\Microsoft.NET\Framework\v2.0.50727\CONFIG\Browsers directory I discovered that version 2.0 of the framework does not ship with configuration details for the BlackBerry browser. Some of the older browsers are covered with the goAmerica.browser configuration file but that doesn't cover the newer browsers.

To find out what the framework knows about a browser you can create a page which writes out some details:

protected void Page_Load(object sender, EventArgs e)
    Response.Write("<B>User Agent:</B> " + Request.UserAgent + "<BR />");
    Response.Write("<B>IsMobileDevice:</B> " + Request.Browser.IsMobileDevice
    + "<BR />");
    Response.Write("<B>Browser:</B> " + Request.Browser.Browser + "<BR />");
    Response.Write("<B>Version:</B> " + Request.Browser.Version + "<BR />");
    Response.Write("<B>Major:</B> " + Request.Browser.MajorVersion + "<BR />");
    Response.Write("<B>Minor:</B> " + Request.Browser.MinorVersion + "<BR />");

Browsing to this page on a Blackberry the UserAgent will return something like this:
   BlackBerry8700/4.1.0 Profile/MIDP-2.0 Configuration/CLDC-1.1 VendorID/-1
This is useful information but Browser name and version information are not returned.

Creating a Blackberry.browser config file is pretty straight forward. Having a read through the other *.browser files will give you an idea of what properties can be set. Here is the configuration which I have created:


  <browser id="BlackBerry" parentID="Default">
      <userAgent match="BlackBerry(?'model'\d+)/(?'version'((?'major'\d+).
(?'minor'\d+).(?'other'\d+)))" />

      <capability name="browser"             value="BlackBerry" />
      <capability name="isMobileDevice"      value="true" />
      <capability name="javascript"          value="true" />
      <capability name="ecmascriptversion"   value="1.3" />          
      <capability name="version"             value="${version}" />
      <capability name="majorVersion"        value="${major}" />
      <capability name="minorVersion"        value="${minor}" />
      <capability name="supportsCss"         value="true" />
      <capability name="frames"              value="false" />
      <capability name="cookies"             value="true" />

In the browser tag we just set the id and parentID attributes. In the identification tag we create a regular expression to capture a match on the userAgent we looked at earlier. Under capabilities we set the various properties for the browser.

One of the most important capabilities here is the ecmascriptversion. It lets the framework know that its ok to write out the __doPostBack javascript method and the __EVENTTARGET & __EVENTARGUMENT hidden fields. These are used by events such as the SelectedIndexChanged on a DropDownList control.

There are many other properties which can be set but I have found these sufficient for my needs. Enter these details in a text file and save as BlackBerry.browser in the C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\CONFIG\Browsers directory.

ASP.NET Browser Registration Tool

Creating the file is only half the job. We now need to let the framework know about it. There is a command line tool called aspnet_regbrowsers.exe which creates an assembly based on the information in the *.browser files and installs the assembly in the global assemly cache.

From a command prompt enter the path to aspnet_regbrowsers.exe and use the -i switch to register the browser configurations. For my installation the path is as follows:
   C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\aspnet_regbrowsers.exe -i
Just check that this is the correct location for your installation.

More information on aspnet_regbrowsers.exe can be found here.


The ecmascriptversion can be an important property for the framework to know about a browser. The applications I have upgraded from ASP.NET 1.1 to 2.0 now behave as they should on the BlackBerry browser.


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


About the Author

Declan Bright
Ireland Ireland
I have been designing and developing business solutions for the aviation and telecommunications industries since 1999. My experience covers a wide range of technologies and I have delivered a variety of web and mobile based solutions.

Comments and Discussions

GeneralMy vote of 5 Pin
hezhicheng8-Mar-11 8:19
Memberhezhicheng8-Mar-11 8:19 
Generalecmascriptversion shows 1.4 but __EventArgument and __EventTarget still don't render Pin
dubloons13-Dec-10 7:31
Memberdubloons13-Dec-10 7:31 
GeneralSupport for different Blackberry models Pin
muppet00711-Mar-10 23:51
Membermuppet00711-Mar-10 23:51 
GeneralMobile Device Browser File from Codeplex - over 400 devices (including Blackberries) Pin
neilio2-Aug-09 15:52
Memberneilio2-Aug-09 15:52 
GeneralIf this isn't working for you - make sure to check the line breaks in your BlackBerry.browser file. Pin
Jesse Fatherree6-Jul-09 10:57
MemberJesse Fatherree6-Jul-09 10:57 
General3.5 Support [modified] Pin
Insomniac8224-Feb-09 9:21
MemberInsomniac8224-Feb-09 9:21 
GeneralRe: 3.5 Support Pin
muppet00711-Mar-10 23:47
Membermuppet00711-Mar-10 23:47 
GeneralQuestion that might be specific to my BlackBerry Pin
zuurg18-Dec-08 11:45
Memberzuurg18-Dec-08 11:45 
GeneralVB page load code Pin
bdempster4-Aug-08 9:52
Memberbdempster4-Aug-08 9:52 
GeneralYou can add the BlackBerry.browser file to your project Pin
Rohinton Collins29-Apr-08 13:32
MemberRohinton Collins29-Apr-08 13:32 
GeneralRe: You can add the BlackBerry.browser file to your project Pin
Declan Bright30-Apr-08 9:40
MemberDeclan Bright30-Apr-08 9:40 
GeneralThank you! Pin
Bo Vistisen9-Mar-08 3:15
MemberBo Vistisen9-Mar-08 3:15 
Just what I needed. Works perfectly with my 8310 Curve.
GeneralRe: Thank you! Pin
Declan Bright16-Mar-08 7:39
MemberDeclan Bright16-Mar-08 7:39 
Questionpostback still failing, any ideas? Pin
dB.29-Oct-07 17:39
MemberdB.29-Oct-07 17:39 
AnswerRe: postback still failing, any ideas? Pin
Declan Bright29-Oct-07 23:24
MemberDeclan Bright29-Oct-07 23:24 
GeneralRe: postback still failing, any ideas? Pin
dB.30-Oct-07 12:15
MemberdB.30-Oct-07 12:15 
Questioni want send message to blackberry from windows desktop application Pin
sriram30308-Aug-07 19:14
Membersriram30308-Aug-07 19:14 
AnswerRe: i want send message to blackberry from windows desktop application Pin
Declan Bright8-Aug-07 21:24
MemberDeclan Bright8-Aug-07 21:24 
GeneralA slight change needed Pin
zewar962-Aug-07 7:51
Memberzewar962-Aug-07 7:51 
GeneralRe: A slight change needed Pin
Declan Bright2-Aug-07 21:51
MemberDeclan Bright2-Aug-07 21:51 
GeneralRe: A slight change needed Pin
BrendanM72114-Aug-07 6:01
MemberBrendanM72114-Aug-07 6:01 
GeneralRe: A slight change needed Pin
harsha.809-Sep-09 3:01
Memberharsha.809-Sep-09 3:01 
GeneralStill Not Working Pin
gialo24-Jul-07 14:23
Membergialo24-Jul-07 14:23 
GeneralRe: Still Not Working Pin
Declan Bright24-Jul-07 21:22
MemberDeclan Bright24-Jul-07 21:22 
GeneralBlackberry ASP SQL Data Problem Pin
nwack-nwack21-May-07 11:02
Membernwack-nwack21-May-07 11:02 

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.