Converting Applications from ASP.NET AJAX RC to ASP.NET AJAX RTM

Migrating an existing application requires the following steps:

1. Installing the new ASP.NET AJAX release.
2. Updating existing ASP.NET Web pages that use the AutoCompleteExtender control.
3. Modifying the application configuration (Web.config file).

Each of these steps is described below.

To install the new ASP.NET AJAX release, download it from the ASP.NET AJAX Web site and follow these steps.

1. Uninstall the RC version of ASP.NET AJAX by using the Add and Remove Programs application in Control Panel.
2. If you installed the ASP.NET 2.0 Futures December CTP release, uninstall it by using the Add and Remove Programs application in Control Panel.
3. Install the Microsoft ASP.NET 2.0 AJAX Extensions 1.0 Final release.
4. Determine whether you need to install the Microsoft ASP.NET 2.0 AJAX Futures January CTP release. For a complete list of features that require the AJAX Futures January CTP release, see the feature guide on the ASP.NET AJAX Web site.
5. If you are using ASP.NET 2.0 January Futures CTP release features, install it and replace the Microsoft.Web.Preview.dll assembly in the Bin folder with the one located in the following folder:

   %ProgramFiles%\Microsoft ASP.NET\ASP.NET 2.0 AJAX Futures January CTP\v1.0.61025

6. If you need features from the ASP.NET AJAX Control Toolkit, install it.

   Note:  We strongly recommend that you take advantage of the controls from the "Atlas" Control Toolkit. For information about changes, see the online documentation on the ASP.NET AJAX Control Toolkit Web site.

The AutoCompleteExtender control is now part of the ASP.NET AJAX Control Toolkit. If you used the AutoCompleteExtender control in ASP.NET Web pages, you must install the Control Toolkit and then update the tag prefix for that control. The following examples show the required change.

ASP.NET AJAX RC

<asp:AutoCompleteExtender ID="autoComplete1" runat="server"
    TargetControlID="LocationTextBox2"
    ServicePath="UIService.asmx"
    ServiceMethod="GetCities" />

ASP.NET AJAX RTM

<ajaxToolkit:AutoCompleteExtender ID="autoComplete1" runat="server"
    TargetControlID="LocationTextBox2"
    ServicePath="UIService.asmx"
    ServiceMethod="GetCities" />

As part of the migration from the RC to the RTM release, you must manually change the Web.config file of existing ASP.NET AJAX applications as shown in this section. (If you are using Visual Studio 2005 to create a new ASP.NET AJAX Web application, the Web.config file in the new application will already have the appropriate settings.)

<system.web>
  <pages>
    <controls>

• The AutoCompleteExtender control is now part of the ASP.NET Control Toolkit and is therefore not part of the same namespace as controls in the core release. To use the AutoCompleteExtender control, you must download and install the Control Toolkit as described earlier, and then register the toolkit tag prefix by adding the following entry in the <controls> section:

<add tagPrefix="ajaxToolkit" namespace="AjaxControlToolkit"
  assembly="AjaxControlToolkit"/>

<system.web>
  <pages>
    <tagMapping>

• The ASP.NET AJAX validator controls that were part of the RC release have been removed. You must remove the following registration entries for those controls from the <tagMapping> section and remove any instances of these controls in your pages.

<add tagType="System.Web.UI.WebControls.CompareValidator"
    mappedTagType="System.Web.UI.Compatibility.CompareValidator,
    System.Web.Extensions, Version=1.0.61025.0, Culture=neutral,
    PublicKeyToken=31bf3856ad364e35"/>

<add tagType="System.Web.UI.WebControls.CustomValidator"
  mappedTagType="System.Web.UI.Compatibility.CustomValidator,
  System.Web.Extensions, Version=1.0.61025.0, Culture=neutral,
  PublicKeyToken=31bf3856ad364e35"/>

<add tagType="System.Web.UI.WebControls.RangeValidator"
  mappedTagType="System.Web.UI.Compatibility.RangeValidator,
  System.Web.Extensions, Version=1.0.61025.0, Culture=neutral,
  PublicKeyToken=31bf3856ad364e35"/>

<add tagType="System.Web.UI.WebControls.RegularExpressionValidator"
  mappedTagType="System.Web.UI.Compatibility.RegularExpressionValidator,
  System.Web.Extensions, Version=1.0.61025.0, Culture=neutral,
  PublicKeyToken=31bf3856ad364e35"/>

<add
  tagType="System.Web.UI.WebControls.RequiredFieldValidator"
  mappedTagType="System.Web.UI.Compatibility.RequiredFieldValidator,
  System.Web.Extensions, Version=1.0.61025.0, Culture=neutral,
  PublicKeyToken=31bf3856ad364e35"/>

<add tagType="System.Web.UI.WebControls.ValidationSummary"
  mappedTagType="System.Web.UI.Compatibility.ValidationSummary,
  System.Web.Extensions, Version=1.0.61025.0, Culture=neutral,
  PublicKeyToken=31bf3856ad364e35"/>

<add verb="*" path="*_AppService.axd" validate="false"
  type="System.Web.Script.Services.ScriptHandlerFactory,
  System.Web.Extensions, Version=1.0.61025.0, Culture=neutral,
  PublicKeyToken=31bf3856ad364e35"/>

<system.web>
  <httpHandlers>

• The Application Service entry point is now implemented as an HTTP handler that requires the following change to the <httpHandlers> section:

<add verb="*"
  path="*_AppService.axd"
  validate="false"
  type="System.Web.Script.Services.ScriptHandlerFactory,
      System.Web.Extensions, Version=1.0.61025.0, Culture=neutral,
      PublicKeyToken=31bf3856ad364e35"/>

<system.webServer>
  <httpHandlers>

• If you are using IIS 7, you must add the following entries as well:

<remove name="WebServiceHandlerFactory-ISAPI-2.0"/>

<add name="ScriptHandlerFactory" verb="*" path="*.asmx"
  preCondition="integratedMode"
  type="System.Web.Script.Services.ScriptHandlerFactory,
      System.Web.Extensions, Version=1.0.61025.0, Culture=neutral,
      PublicKeyToken=31bf3856ad364e35"/>

<add name="ScriptHandlerFactoryAppServices" verb="*"
  path="*_AppService.axd" preCondition="integratedMode"
  type="System.Web.Script.Services.ScriptHandlerFactory,
      System.Web.Extensions, Version=1.0.61025.0, Culture=neutral,
      PublicKeyToken=31bf3856ad364e35"/>

<add name="ScriptResource"
  preCondition="integratedMode" verb="GET,HEAD"
  path="ScriptResource.axd"
  type="System.Web.Handlers.ScriptResourceHandler,
  System.Web.Extensions, Version=1.0.61025.0, Culture=neutral,
  PublicKeyToken=31bf3856ad364e35" />