Click here to Skip to main content
14,934,216 members
Articles / Web Development / HTML
Article
Posted 11 Aug 2006

Stats

133K views
1.1K downloads
41 bookmarked

Using Ajax.NET Pro in a SharePoint Web Part

Rate me:
Please Sign up or sign in to vote.
4.15/5 (7 votes)
11 Aug 20067 min read
The article describes how to configure Ajax.NET Pro with SharePoint so that it can be used in Web Parts.

Introduction

Just like everyone else, I'd heard the buzz about AJAX but had never really tried it out; both from a user perspective, and programmatically! I do a lot of programming for my work, and one of the environments I'm spending a lot of time developing in is SharePoint, and in particular, web parts. Having created quite a few web parts, one of the things I became quite aware of is that performance can be an issue. When there are lots of web parts on a Team site, any user interaction with a web part will cause all of them to have to be refreshed, which can be slow if the web parts are complex (like ours are). So....the answer to me seemed to be AJAX! OK, I was using it as an excuse to try out AJAX, but in the end, it was the right decision to solve my problems. Sometimes, it's better to be lucky than good :)

Being a true programmer at heart (i.e. lazy:)), I decided there must be an easy way to do this! I looked through a whole bunch of AJAX libraries and frameworks out there, but in the end, came across Ajax.NET Professional, and really liked it. It seemed to be robust, complete, lightweight, well used, and well supported. So, next step, how to get it working with my SharePoint Web Part? Well, that was where it got interesting. Although there is great documentation with Ajax.NET, there was nothing specific to SharePoint. Eventually, I found some hints in the Google Ajax.NET forum which then led to me finding a blog entry by Maxim Tarassenko that was enough to get me to a working solution.

This article (I hope!) will serve as a single reference point in what to do to enable Ajax.NET Pro within SharePoint so that web parts can be created that can use AJAX. What I will not be doing is trying to explain how to create web parts or go into detailed examples of Ajax.NET Pro usage! The aim is to make every step clear and easy, even for a SharePoint novice, so if any steps are not clear, let me know and I'll try and explain them better!

Installing Ajax.NET Pro

The example project Web Part was created using version 6.7.20.1. Once this, or the current latest release, has been downloaded and the contents extracted to a directory (you'll need to have it handy for referencing when creating code, so put it somewhere permanent), the following steps will configure SharePoint:

  1. Install AjaxPro.dll into the GAC. I prefer to use the GAC because it makes security easier, and there is only ever one place the DLL is installed to!
  2. Add the AJAX HttpHandler to the web.config file for each SharePoint Portal site that you want to AJAX enable.
  3. Add the /ajaxpro path to the list of excluded paths for each portal site.

Once these steps are done, SharePoint will be able to have web parts that use Ajax.NET pro. There are a couple of tricks that must be used within the server and JavaScript code though!

Installing the Ajax.Net Pro DLL in the GAC

I prefer to use the GAC because it makes security easier, and there is only ever one place the DLL is installed to! There are several ways to do this, but the simplest, to me, is to drag-and-drop the AjaxPro.dll into the c:\windows\Assemblies directory.

Adding the HttpHandler

This step must be done manually by editing the appropriate web.config file for each SharePoint Portal site that Ajax.NET is to be enabled for. In the web.config file, locate the <httpHandlers> section - it will probably have the two default entries as follows:

XML
<httpHandlers>
  <add verb="*" path="/_vti_bin/*.aspx" 
       type="System.Web.UI.PageHandlerFactory, System.Web, 
             Version=1.0.5000.0, Culture=neutral, 
             PublicKeyToken=b03f5f7f11d50a3a" />
  <add verb="*" path="*.aspx" 
       type="Microsoft.SharePoint.ApplicationRuntime.SharePointHandlerFactory, 
             Microsoft.SharePoint, Version=11.0.0.0, Culture=neutral, 
             PublicKeyToken=71e9bce111e9429c" />
</httpHandlers>

Add the following entry to this section:

XML
<add verb="*" path="ajaxpro/*.ashx" 
   type="AjaxPro.AjaxHandlerFactory, AjaxPro, Version=6.7.20.1, 
         Culture=neutral, PublicKeyToken=4735ae9824c7d3ec" />

Excluding the /ajaxpro path

This can be done in one of two ways; either through the (graphical) SharePoint Central Administrator, or by using the (non-graphical) stsadm command-line tool.

Using SharePoint Central Administrator

  1. Click Start, point to All Programs, point to Administrative Tools, and then click SharePoint Central Administration.
  2. On the Central Administration page, under Portal Site and Virtual Server Configuration, click Configure virtual server settings from the Virtual Server List page.
  3. On the Virtual Server List page, select the virtual server you want to configure.
  4. On the Virtual Server Settings page, under Virtual Server Management, click Define managed paths.
  5. In the Add a New Path section, in the Path box, type /ajaxpro.
  6. Select Excluded path for the Type.
  7. Click OK.

Using stsadm

  1. Open a Windows command prompt.
  2. cd C:\Program Files\Common Files\Microsoft Shared\web server extensions\60\BIN (on a side note, I add this to my PATH environment because I use stsadm all the time).
  3. stsadm -o addpath -url http://your_server_portal_name/ajaxpro -type exclusion.

The Web Part Code

The first thing you have to do with Ajax.NET Pro is to register your types (class or classes). This should be done once, so a good place is on page load. The command to register the type is:

C#
AjaxPro.Utility.RegisterTypeForAjax(typeof(UserInfo), this.Page);

Replace the UserInfo with the name of your type.

The other thing that must be done is to register the JavaScript that will be used to implement the AJAX functionality on the clients! I do this in pre-render.

The JavaScript Code

The last "problem" was how to initiate a client side call through Ajax.NET Pro when the web part is first loaded without the user having to do anything! This bit is what took the longest for me to get working:) At first, I thought I could add something to the web parts page load code (same place I put the type registration code), but that does not work. What I really needed to do was add it to the actual page OnLoad event. The trick was to have my JavaScript do it for me! Here is the code, which sits at the top of the JavaScript I registered within the web part:

C#
try{
  window.attachEvent("onload", 
         new Function("AjaxUserInfoInit();"));
}
catch(ex){
    //Do Nothing
}

This will call the JavaScript function AjaxUserInfoInit when the page (web part) is first loaded. In here, I then execute a call, or calls, back to the web part DLL to execute my initial code.

A Word About the Example

The example is very silly and trivial in that all it does is to display a message when the web part is first rendered, letting the user know something is being done (just like Microsoft Outlook Web Access):

Sample startup of a web part

This "something" is a couple of Ajax.NET calls that will return data that is displayed in the web part:

Sample output of a web part

One of the big AJAX debates is what should the AJAX function do; return data so that the JavaScript can dynamically create the HTML from the data and then update the page, or simply return HTML to be displayed? My example uses both methods to display the same data. Again, trivial, but I was testing both approaches to make sure I could do them! As to which approach I will use in the future? Not sure! I guess what I will use will depend on how much data has to be transferred to the client for the JavaScript to be able to generate the HTML. If that information is greater in size than the resulting HTML, then I'll format the HTML in the Server and just transfer the results.

Conclusion

Hopefully, this will get the creative juices flowing, and you'll be able to change your web parts into AJAX extravaganza's:) Well, that's my intention for my customers! I'd like to think that by using AJAX, I will enhance the user's experience by improving the feel and speed of SharePoint - less page refreshes is a good thing.

History

  • 08-02-2006:
    • Original article.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

Share

About the Author

Andrew Hore
Web Developer
United States United States
I've worked in the Document/Records Management and Workflow industry my entire working life, despite wanting to do something completely different and un-related....my wife and 3 kids make sure I stay with that choice! One day I'd like to think I can pursue that other dream.

Comments and Discussions

 
GeneralFacing Problem...Kindly Help... Pin
minni_walia14-Aug-08 1:53
Memberminni_walia14-Aug-08 1:53 
QuestionNot working at all Pin
Tornn17-Jul-08 23:06
MemberTornn17-Jul-08 23:06 
AnswerRe: Not working at all Pin
Andrew Hore18-Jul-08 1:29
MemberAndrew Hore18-Jul-08 1:29 
AnswerRe: Not working at all Pin
Alain de la Kethulle6-Jan-09 6:04
MemberAlain de la Kethulle6-Jan-09 6:04 
Generalgetting web part properties and current site context Pin
ben jiang29-May-08 2:36
Memberben jiang29-May-08 2:36 
QuestionAlert Time out when passing Params to Web Part method Pin
ben jiang28-May-08 14:48
Memberben jiang28-May-08 14:48 
AnswerRe: Alert Time out when passing Params to Web Part method Pin
ben jiang29-May-08 2:42
Memberben jiang29-May-08 2:42 
Generalshowing a webpart with anonymous [modified] Pin
ptvce10-Mar-08 21:15
Memberptvce10-Mar-08 21:15 
GeneralIt works - few things to keep in mind Pin
Benav21-Aug-07 16:13
MemberBenav21-Aug-07 16:13 
GeneralJavascript undefined Pin
hunhun26-Oct-06 16:27
Memberhunhun26-Oct-06 16:27 
GeneralConnectable webpart Pin
Medivl8-Oct-06 22:26
MemberMedivl8-Oct-06 22:26 
GeneralRe: Connectable webpart Pin
Andrew Hore9-Oct-06 7:03
MemberAndrew Hore9-Oct-06 7:03 
GeneralAdd Verb directions are incorrect - fixed here Pin
svintinner27-Sep-06 4:19
Membersvintinner27-Sep-06 4:19 
GeneralRe: Add Verb directions are incorrect - fixed here Pin
Andrew Hore27-Sep-06 7:02
MemberAndrew Hore27-Sep-06 7:02 
Questionhow to go on [modified] Pin
sirilein19-Sep-06 3:36
Membersirilein19-Sep-06 3:36 
AnswerRe: how to go on Pin
basstrap26-Oct-06 9:51
Memberbasstrap26-Oct-06 9:51 
AnswerRe: how to go on Pin
basstrap15-Dec-06 11:04
Memberbasstrap15-Dec-06 11:04 
QuestionWeb Part hangs Pin
wegrata30-Aug-06 8:21
Memberwegrata30-Aug-06 8:21 
NewsHi Andy, Pin
Rishi Kesan20-Aug-06 19:06
MemberRishi Kesan20-Aug-06 19:06 
QuestionIt's not working 4 me .... [modified] Pin
Rishi Kesan17-Aug-06 19:10
MemberRishi Kesan17-Aug-06 19:10 
AnswerRe: It's not working 4 me .... Pin
Andrew Hore21-Aug-06 4:39
MemberAndrew Hore21-Aug-06 4:39 
GeneralRe: It's not working 4 me .... Pin
Rishi Kesan21-Aug-06 20:40
MemberRishi Kesan21-Aug-06 20:40 
GeneralRe: It's not working 4 me .... Pin
Andrew Hore23-Aug-06 5:05
MemberAndrew Hore23-Aug-06 5:05 
GeneralRe: It's not working 4 me .... Pin
Rishi Kesan23-Aug-06 20:18
MemberRishi Kesan23-Aug-06 20:18 
GeneralRe: It's not working 4 me .... Pin
svintinner28-Sep-06 10:27
Membersvintinner28-Sep-06 10:27 

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.