Archive Note

With version 2.0 now on offer, Integration via Inheritance, the most popular way to integrate Ajaxium v1.x into ASP.NET 1.x and ASP.NET 2.0 projects to make them AJAX-enabled, has become obsolete. Version 2.0 enables you to integrate Ajaxium by merely adding one line to a page codebehind file or by dragging the Ajaxium Processor from the Visual Studio toolbox onto an ASP.NET Web Form you want to be AJAX-ed.

This article is intended for those of our customers who continue using previous versions of the component.

Integration via Inheritance

Integration via inheritance is the easiest way to use Ajaxium. The step-by-step instruction below will enable AJAX on your ASP.NET page.
First of all, you have to add a reference to Ajaxium.dll to your project. To do it:

1. Open the Visual Studio Solution Explorer, click the right mouse button on the References folder and choose the Add Reference from the pop-up menu.
2. After the dialog appears, open the .NET tab, and click the Browse button. Select the Ajaxium.dll and click Open.
3. You will see the Ajaxium.dll assembly appear in the bottom list of components, now just press the OK button.
4. Set the Copy Local property of the just-added Ajaxium.dll to True.

   If you plan to enable AJAX on many projects in your solution, you have to add references to each project in the solution (repeat steps 1-4).

   Now you have to add the Ajaxium configuration section to your Web.config file.

5. Open the Web.config file and add the following statements to the <configuration> section:

   <configuration>
   ...

      

     <configSections>

       <section name="Ajaxium" type="Ajaxium.ConfigSection, Ajaxium"/>

     </configSections>

     

     <Ajaxium AjaxiumEnabled="true"

              PreloadAjaxContent="true"

              FallBackTimeout="20" 

              FallBackTimeoutMessage="Request timed out, falling back to ASP.NET"

              ForceFocusScript="true"

                 

       License="LICENSE TYPE"

       IssuedTo="COMPANY NAME"

       Key="LICENSE KEY"

       />
   
   ...

   </configuration>

   The final step is to update the source code of the page you want to be AJAX-enabled. To do it:

6. Open the file containing the source code of the page you want to be AJAX-enabled in the Visual Studio.
7. Navigate to the page class declaration and replace the inheritance from System.Web.UI.Page with Ajaxium.Page.

   In most cases the developer's intention is to enable AJAX on all pages of a project. This can be achieved by repeating steps 5-6 for each page class in the project.

8. Done! Start your application and verify that AJAX is enabled on all pages you have updated.

Hint: you can add the inheritance statement to your base Page class if it is implemented.