如何：将 ASP.NET AJAX 1.0 Web 项目升级至 .NET Framework 3.5

项目
10/22/2014

更新：2007 年 11 月

Visual Studio 2008 包含一个新版本的 ASP.NET AJAX，此版本在 ASP.NET AJAX 1.0 版的基础上提供了一些改进。本主题介绍如何升级现有的 ASP.NET AJAX 1.0 网站和 Web 应用程序项目，以利用 .NET Framework 3.5 和 Visual Studio 2008 中的 AJAX 支持。

升级至新版本的 ASP.NET AJAX

升级 ASP.NET AJAX 网站或 Web 应用程序项目

创建项目的备份副本。
启动 Visual Studio 2008。
打开该项目。执行下列操作之一：
- 如果要处理网站，请在**“文件”菜单中单击“打开网站”**，然后打开网站或 IIS 虚拟目录。
- 如果要处理 Web 应用程序项目，请在**“文件”菜单中单击“打开项目”**，接着浏览至项目文件，然后将其打开。
此时**“Visual Studio 转换向导”**启动。请按照向导中的步骤升级项目。
当 Visual Studio 2008 提示是否要升级网站时，请单击**“是”**。

更新 ASP.NET AJAX 控件工具包程序集

如果应用程序包含 ASP.NET AJAX 控件工具包中的控件或扩展程序，则必须升级至新版本的控件工具包，才能使用 .NET Framework 3.5 运行该应用程序。您可以从 Codeplex Web site（Codeplex 网站）下载 ASP.NET AJAX 1.0 控件工具包的最新版本。

重要说明：
该控件工具包是一个由社区支持的库，Microsoft 并不对它提供支持。

更新 ASP.NET AJAX 控件工具包程序集

下载 .NET Framework 3.5 的 ASP.NET AJAX 控件工具包的最新版本。该控件工具包可以从 Codeplex Web site（Codeplex 网站）下载。
在 Windows 资源管理器中，右击该控件工具包的 .zip 文件，然后单击**“全部提取…”**。
将内容提取至同一目录下的 AjaxControlToolkit-Framework3.5 文件夹中。
将 AjaxControlToolkit.dll 程序集从 AjaxControlToolkit-Framework3.5\SampleWebSite\Bin 复制到应用程序的 Bin 目录，并替换该控件工具包程序集的早期版本。

此外，您还可以选择将 ASP.NET AJAX 控件工具包控件安装到 Visual Studio 的**“工具箱”**中。

将 ASP.NET AJAX 控件工具包控件安装到“工具箱”中

在 ASP.NET AJAX 1.0 网站或项目中，打开一个 ASP.NET 网页（Web 窗体）。
右击**“工具箱”，然后单击“添加选项卡”**。
为新选项卡提供一个名称，例如“ASP.NET AJAX Toolkit 1.0”。
右击新选项卡，然后单击**“选择项…”**。

说明：

首次打开此对话框时，可能会出现延迟。
在**“选择工具箱项”对话框中，单击“浏览…”**。
浏览至 \AjaxControlToolkit-Framework3.5\SampleWebSite\Bin，选择“AjaxControlToolkit.dll”，然后单击**“打开”**。

随即将在**“选择工具箱项”**对话框内选中该控件工具包中的所有控件。
单击**“确定”**

这些控件将添加到**“工具箱”**中。

说明：
首次打开此对话框时，可能会出现延迟。

在升级的项目中使用 AJAX 1.0 组件

Microsoft 已推出一个新版本的 Microsoft ASP.NET AJAX 控件工具包，此工具包用 .NET Framework 3.5 中的 ASP.NET AJAX (System.Web.Extensions) 程序集编译而成。但是，您的应用程序可能包含使用 ASP.NET AJAX 1.0 编译的第三方组件或程序集。在将网站升级至 .NET Framework 3.5 时，将向 ASP.NET AJAX 3.5 应用程序的 Web.config 文件中添加一个 bindingRedirect 节。此节可使第三方的预编译组件绑定到 System.Web.Extensions 程序集的 3.5 版，而不是绑定到 1.0 版。

说明：
bindingRedirect 节仅适用于运行时。在设计时，第三方组件将引用 System.Web.Extensions 程序集的 1.0 版。若要使控件设计器正常运行，必须安装 AJAX 1.0。如果可能，应获取为 System.Web.Extensions 程序集的 3.5 版编译的组件版本。