Get Started with the AJAX Control Toolkit (VB)

by Microsoft

Learn all you need to know to get started using the AJAX Control Toolkit.

The AJAX Control Toolkit contains more than 30 free controls that you can use in your ASP.NET applications. In this tutorial, you learn how to download the AJAX Control Toolkit and add the toolkit controls to your Visual Studio/Visual Web Developer Express toolbox.

Downloading the AJAX Control Toolkit

The AJAX Control Toolkit is an open source project developed by the members of the ASP.NET community and the ASP.NET team.

Downloading the AJAX Control Toolkit

Figure 01: Downloading the AJAX Control Toolkit(Click to view full-size image)

After you download the file, you need to unblock the file. Right-click the file, select Properties, and click the Unblock button (see Figure 2).

Unblocking the AJAX Control Toolkit ZIP file

Figure 02: Unblocking the AJAX Control Toolkit ZIP file(Click to view full-size image)

After you unblock the file, you can unzip the file: Right-click the file and select the Extract All menu option. Now, we are ready to add the toolkit to the Visual Studio/Visual Web Developer toolbox.

Adding the AJAX Control Toolkit to the Toolbox

The easiest way to use the AJAX Control Toolkit is to add the toolkit to your Visual Studio/Visual Web Developer toolbox (see Figure 3). That way, you can simply drag a toolkit control onto a page when you want to use it.

AJAX Control Toolkit appears in toolbox

Figure 03: AJAX Control Toolkit appears in toolbox(Click to view full-size image)

First, you need to add an AJAX Control Toolkit tab to the toolbox. Follow these steps.

  1. Create a new ASP.NET Website by selecting the menu option File, New Website. Double-click the Default.aspx in the Solution Explorer window to open the file in the editor.
  2. Right-click the Toolbox beneath the General Tab and select the menu option Add Tab (see Figure 4).
  3. Enter a new tab named AJAX Control Toolkit.

Adding a new tab

Figure 04: Adding a new tab(Click to view full-size image)

Next, you need to add the AJAX Control Toolkit controls to the new tab. Follow these steps:

  • Right-click beneath the AJAX Control Toolkit tab and select the menu option Choose Items (see Figure 5).
  • Browse to the location where you unzipped the AJAX Control Toolkit and select the AjaxControlToolkit.dll assembly.

Choose items to add to the toolbox

Figure 05: Choose items to add to the toolbox(Click to view full-size image)

After you complete these steps, all of the toolkit controls will appear in your toolbox.

Upgrading to a New Version of the Toolkit

If you were using an older release of the Toolkit and now need to move to a later version here are the recommended steps:

  • Binaries - Delete the old version of the AjaxControlToolkit.dll assembly from your website Bin folder.
  • Toolbox Items - Delete the AJAX Control Toolkit tab and follow the steps above to re-create the tab with the new version of the AjaxControlToolkit.dll assembly.