介绍

Atlas 客户端库是一个 JavaScript（.js）文件集合，为 ASP.NET 应用程序建立增强的用户界面（UI）而封装了一个面向对象的类库。客户端库的用途就是简化对建立拥有丰富 UI 的并能够跨浏览器运行的 AJAX 应用程序的处理。

客户端库中包括了什么

客户端库由在 Atlas 汇编集文件中被封装成资源的 .js 文件集合所组成。如果你运行了 Atlas 安装包，那么它将把汇编集（名为 Microsoft.Web.Atlas.dll 的文件）的一个副本存放到被选择的安装目录中。你可以把这个汇编集添加到 Web 应用程序的 Bin 目录中，从而允许你同时在服务器中以及被引用成标准客户端脚本的脚本库文件中对 Atlas 的功能进行访问。如果你已经运行了 Atlas 安装包，你就能够查看到客户端库中的 .js 文件的内容。所有的这些文件中都同时包括有调试和开发两个版本。转到你选择的安装位置，并查找名为 ScriptLibrary 的子目录。一个典型的安装路径的位置是：

..Program Files\Microsoft ASP.NET\Atlas\v2.0.50727\Atlas\ScriptLibrary

Atlas 客户端库中包括了如下所示的 .js 文件：

• AtlasRuntime.js。Atlas 运行时文件是用来运行 Atlas 特征时所必需的最基本的脚本。它包含最基本的 Atlas 特征集合：Web 服务、网络服务、以及对 Javascript 面向对象的基本扩展。出于脚本下载量最小化的目的，你可以只在不需要完整的 Atlas 客户端控件和功能集合的时候对这些脚本进行引用。在你只需要从 JavaScript 中调用 Web 服务、为调用过程而编写汇聚参数的自定义脚本、以及处理结果的时候，就可以考虑只使用运行时脚本。下面的部分通过使用 Atlas 客户端库说明了如何只对运行时文件进行引用。
• Atlas.js。Atlas.js 文件包含了完整的 Atlas 特征集，默认时还会包括 Atlas 的运行时支持。Atlas.js 为运行时特征加入了完整的 Atlas 客户端组件和控件集合，以及指定数据绑定和客户端 UI 细节的 Atlas 声明语法。这是最经常被使用的库脚本，并且在你在页面中添加 Atlas ScriptManager 组件的时候默认是被包括在内的。相关内容情参考使用 Atlas 客户端库的下一个部分。
• AtlasCompat.js。为 Atlas 特征提供跨浏览器的兼容性。
• AtlasCompact2.js。为 Atlas 特征提供跨浏览器的兼容性。
• AtlasFX.js。包含与 Atlas.js 相同的内容，但是不包括 AtlasRuntime.js 代码。与小型配件一起在已托管的场景中使用。
• AtlasUIDragDrop.js。实现拖放特征。
• AtlasUIGlitz.js。实现特殊的 UI 效果。
• AtlasUIMap.js。实现虚拟映射特征。
• AtlasWebParts.js。为与 ASP.NET Web 部件控件的合作而实现的 Atlas 特征。
• GadgetRuntime.js。被用于 Microsoft 和 MSN 的运行时代码。

客户端库由 4 个逻辑层所组成：

• Javascript 扩展。Javascript 扩展为原始的 Javascript 添加了许多对象、功能、以及数据类型。注册方法还允许你创建对于 OO 构造（如类、命名空间、枚举、继承、以及接口实现）的模仿。
• 基类库。基类库是一个经常被用来调试、处理事件、处理字符串、Web 服务、访问托管环境、计时器、以及组件的类集合。
• 核心 UI 框架。核心 UI 框架包括为 UI 架构以及与 DOM 和 DHTML 进行交互的区块构造对象。这包括一个基控件对象、一个行为集合、验证、数据绑定、客户端内容模板、拖放、以及其他 UI 特征。
• UI 工具包。UI 工具包包含一个比标准 HTML 控件拥有更多丰富能力的单独客户端控件的集合。其中包括多数典型控件（如超连接、列表视图、选择框、数据视图、按钮、复选框、文本框、标签、数据源、计时器、等等）。

使用 Atlas 客户端库中的脚本

每个使用 Atlas 功能的页面都必须对客户端库进行访问。这个访问客户端脚本的机制就是 ScriptManager 控件。每个使用 Atlas 特征的页面中都必须拥有一个（并且是唯一一个）ScriptManager 控件。默认时，ScriptManager 控件自动包括一个对主 Atlas.js 文件（同样包括了一个对更基本的 AtlasRuntime.js 文件的引用）的引用。

这是所有 Atlas 开发情节中最常见的，在你在代码中既使用了 Atlas 服务器端控件又使用了 Atlas 客户端组件的时候，你就需要对标准的 Atlas 脚本组件（如 Atlas 客户端组件、控件、以及由 Atlas.js 文件所创建的声明语法）进行引用。在需要 Atlas 脚本组件的时候，与你在大部分常规开发场合中一样，如下声明的 ScriptManager 引用是默认时对 Atlas.js 的必需引用：

<atlas:ScriptManager  />

在有些情况下，在你需要引用不同的客户端库脚本的时候，你必须按照不同的方式来声明 ScriptManager 控件。如下所示的是一些常见的脚本定义情节。

专用脚本引用情节

• 使用 AtlasRuntime.js。在你需要为页面提供一个更小尺寸的下载版本的时候，并且你只从脚本（表示你不需要所有的 Atlas 客户端组件）中对 Web 服务进行调用，那么你就可以只调用 AtlasRuntime.js 文件，从而排除其他所有文件。要这样做，就需要按照如下范例一样来声明 ScriptManager 控件：

  <atlas:ScriptManager  />
  

  把 EnableScriptComponents 参数值设置为 false 表示默认的情节（载入 Atlas.js 和 AtlasRuntime.js）并不会发生，并且只有 AtlasRuntime.js 才被引用到页面中。

• 使用兼容性脚本。你从不需要调用兼容性脚本；它们会在特定的客户端浏览器所必需的时候自动被调用。
• 使用专用特征。要使用专用的 Atlas 特征（如拖放或 UI 效果），你必须通过名称来引用专门的脚本。当前能够通过名称被引用的 Atlas 脚本包括：AtlasUIDragandDrop、AtlasUIGlitz、AtlasUIMap、以及 AtlasWebParts。一个包括两个脚本的引用如下范例所示：

  <atlas:ScriptManager >
    <scripts>
      <atlas:scriptreference scriptname="AtlasUIDragDrop" />
      <atlas:scriptreference scriptname="AtlasUIGlitz" />  
    </scripts>
  </atlas:ScriptManager>
  

  注意在你引用这些专门的脚本的时候，你只能够通过不包括 .js 文件扩展名在内的名称来对它们进行引用。要引用一个自定义的 .js 脚本，就需要指定一个用于 Custom 的 ScriptName 参数值，然后添加一个 Path 参数并提供到自定义脚本的路径来作为该参数的值。