ASP.NET 实践：安装 ASP.NET Atlas

介绍

本文说明了如何把 Atlas 安装到你的计算机中。其中主要包括三个场景：

• 首先安装 Atlas。

• 创建一个 Atlas 应用程序。

• 为现有的 ASP.NET 应用程序添加 Atlas 特征。

首先安装 Atlas

如果你以前从未安装过 Atlas，那么你必须先下载一些必需的文件来创建 Atlas 应用程序。要这样做，你应该下载并运行一个 Windows 安装包（.msi）文件并在你的计算机中安装如下文件：

• 一个名为 Microsoft.Web.Atlas.dll 的 Atlas 汇编集，并存放到如下目录中：

  C:\Program Files\Microsoft ASP.NET\Atlas\v2.0.50727\Atlas
  

  该汇编集混合了一些脚本文件（.js 文件）来组成 Atlas 的客户端脚本库。

• 一个可选择的用来创建空白 Atlas Web 应用程序的 Visual Studio 网站模板。

• Windows 通信基础（WCF）组件。WCF 是建立软件服务的 Microsoft 新平台。使用它的环境与你当前所使用的 ASP.NET Web 服务（ASMX）的环境或者可能使用的其他通信技术（如 MSMQ、Remoting、或者企业服务）的环境相同。

  提示：Windows 通信基础是当前预发布的软件。WCF 将会发布成 Windows Vista 操作系统的一部分，并且作为 WinFX 运行环境组件的一部分为 Windows XP 和 Windows Server 2003 可用。这个 Atlas 版本中对 WCF 的支持需要使用到 2006 年二月的技术预览版本的 WinFX。关于从 Atlas 中建立并使用 WCF 服务的信息，请参考：［在 Atlas 中使用 Windows 通信基础（WCF）］。

下载并安装 ASP.NET Atlas 开发包

1. 在浏览器中，导航到 Atlas 下载页面。

2. 单击安装 Atlas 的链接并把 AtlasSetup.msi 文件下载到你的计算机目录中。

3. 在本地运行你刚才所保存的 AtlasSetup.msi 文件。将会出现安装向导：

   

4. 单击 Next 然后接受许可协议。

5. 再次单击 Next。将会询问你是否需要安装 Visual Studio 工程模板：

   

   如果你打算在 Visual Studio 中创建 ASP.NET Atlas Web 应用程序，需要确定 Install Atlas Visual Studio Project Template 复选框已经被选中。这个模板允许你在 Visual Studio 中创建已预配备 Atlas 组件的新网站。

   提示：要安装并使用这个模板，你必须安装有 Microsoft Visual Studio 2005 或 Microsoft Visual Studio 2005 Express Edition。

6. 单击 Next。你将被提示是否在 IIS 中注册 .asbx 文件名扩展：

   

   .asbx 扩展用来识别 Atlas 桥文件（用来与应用程序之外的 Web 服务进行通信的组件）。桥文件的一个用途就是获取其他网站的数据并结合到应用程序中。如果你的应用程序将要从外部 Web 服务中获取数据，建议你还是注册 .asbx 文件扩展名。

7. 单击 Next，然后再单击 Next 启动安装进程：

   

8. 如果你选择了安装 Atlas Visual Studio 工程模板，那么安装包会启动 Visual Studio Content Installer 窗口：

   

   提示：如果你看见一个关于内容没有被标记的警告，然后被提示是否继续的时候，单击 Yes。

9. 为特定语言版本的 Visual Studio 模板选择相应的复选框进行安装，单击 Next，然后单击 Finish。

10. 关闭 Visual Studio Content Installer 窗口，然后关闭 Atlas 安装包。

在 Visual Studio 中创建一个 ASP.NET Atlas 工程

在安装 Atlas 文件和 Atlas Visual Studio 工程模板之后，你就可以在 Visual Studio 2005 中创建已配备 Atlas 特征的新网站了。

创建新的 Atlas 网站：

1. 启动 Visual Studio。

2. 在 File 菜单中，单击 New Web Site。（也可以单击 New，然后再单击 Web Site。）

3. 在 My Templates 下面，选择 ASP.NET Atlas Web Site。

4. 选择要安置的位置，选择你需要用于该网站的编程语言，并输入或浏览需要创建网站的本地路径：

   

5. 单击 OK。

在你创建新的 Atlas 网站的时候，Visual Studio 会把 Atlas 的运行时汇编集从它的安装位置复制网站的 Bin 目录中。Visual Studio 同样生成一个已对运行 Atlas 应用程序所必需的设定进行了预配置的 Web.config 文件。

为现有的 ASP.NET 应用程序添加 Atlas 特征

你能够在现有的 ASP.NET 应用程序中添加 Atlas 能力。

为 ASP.NET 应用程序添加 Atlas 特征：

1. 在 Visual Studio 中打开 ASP.NET 应用程序。

2. 把 Atlas 的运行时汇编集（Microsoft.Web.Atlas.dll）从它的安装目录复制到应用程序的 Bin 目录中。默认时，Atlas 汇编集被安装在这个位置：

   C:\Program Files\Microsoft ASP.NET\Atlas\v2.0.50727\Atlas
   

3. 打开 Atlas 默认位置中的 Web.config 文件。

4. 把 Atlas 所必需的元素复制到应用程序根目录的 Web.config 文件中。

   把这些元素复制成为 <configuration> 元素的子元素：

     <configSections>
       <sectionGroup name="microsoft.web" type="Microsoft.Web.Configuration.MicrosoftWebSectionGroup">
         <section name="converters" type="Microsoft.Web.Configuration.ConvertersSection"/>
       </sectionGroup>
     </configSections>
   
     <microsoft.web>
       <converters>
         <add type="Microsoft.Web.Script.Serialization.Converters.DataSetConverter"/>
         <add type="Microsoft.Web.Script.Serialization.Converters.DataRowConverter"/>
         <add type="Microsoft.Web.Script.Serialization.Converters.DataTableConverter"/>
       </converters>
     </microsoft.web>
   

   把这些元素复制成为（或整合成） <system.web> 元素的子元素：

       <pages>
         <controls>
           <add namespace="Microsoft.Web.UI" assembly="Microsoft.Web.Atlas" tagPrefix="atlas"/>
           <add namespace="Microsoft.Web.UI.Controls" assembly="Microsoft.Web.Atlas" tagPrefix="atlas"/>
         </controls>
       </pages>
   
       <!-- ASMX 被映射到一个新的处理器，所以代理 javascript 脚本同样能够提供服务。 -->
       <httpHandlers>
         <remove verb="*" path="*.asmx"/>
         <add verb="*" path="*.asmx" type="Microsoft.Web.Services.ScriptHandlerFactory" validate="false"/>
       </httpHandlers>
       <httpModules>
         <add name="ScriptModule" type="Microsoft.Web.Services.ScriptModule"/>
       </httpModules>
   

5. 关闭所有文件。