附录A 使用ASP.NET AJAX JavaScript Class Browser查看客户端类型

本文来自《ASP.NET AJAX程序设计 第II卷：客户端Microsoft AJAX Library相关》的附录A。

ASP.NET AJAX提供了丰富的客户端JavaScript类型，不过其文档尚不够完善，未能覆盖到类库中所有的类型。幸运的是，Eilon Lipton给我们带来了一个非常好用的工具——ASP.NET AJAX JavaScript Class Browser，用来辅助查看ASP.NET AJAX各个客户端类型的属性、方法和事件。

该ASP.NET AJAX JavaScript Class Browser可以在Eilon Lipton的Blog（http://weblogs.asp.net/leftslipper/）中下载，其本身就是一个用ASP.NET AJAX编写的Web站点。

首先将下载的压缩包解压至某一目录中。为了可以查看到ASP.NET AJAX Futures CTP脚本中所包含的类型，我们随后要将Microsoft.Web.Preview.dll，即ASP.NET AJAX Futures CTP的程序集拷贝到该Web站点的bin\目录中。

打开该Web站点中的ClassBrowser.master文件，在其ScriptManager中添加相应的ASP.NET AJAX Futures CTP中各个脚本的引用。如下粗体部分所示：

<asp:ScriptManager runat="server" ID="ScriptManager1" EnablePartialRendering="false">
    <Scripts>
        <asp:ScriptReference Name="MicrosoftAjaxWebForms.js" />
        <asp:ScriptReference Name="MicrosoftAjaxTimer.js" />

        <asp:ScriptReference Name="PreviewScript.js"
            Assembly="Microsoft.Web.Preview" />
        <asp:ScriptReference Name="PreviewGlitz.js"
            Assembly="Microsoft.Web.Preview" />
        <asp:ScriptReference Name="PreviewDragDrop.js"
            Assembly="Microsoft.Web.Preview" />
        <asp:ScriptReference Name="PreviewWebParts.js"
            Assembly="Microsoft.Web.Preview" />

        <asp:ScriptReference
            Path="ScriptLibrary/AjaxClassBrowser.Reflection.js" />
        <asp:ScriptReference
            Path="ScriptLibrary/AjaxClassBrowser.ClassWriter.js" />
    </Scripts>
</asp:ScriptManager>

这样即完成了ASP.NET AJAX JavaScript Class Browser的配置。运行该Web站点，可以看到页面左边的导航树按照命名空间对客户端类型进行了归类。展开某个命名空间并选择其中的某个类型，页面右侧将以类似C#语法的方式显示出该客户端类型的原型声明，包括类型的继承关系、实现接口及其属性、方法和事件等。如图A-1所示。

图A-1 ASP.NET AJAX JavaScript Class Browser的界面

如果需要的话，我们也可以将自定义的ASP.NET AJAX客户端类型添加到ClassBrowser.master文件的ScriptManager中。随后即可在ASP.NET AJAX JavaScript Class Browser界面中浏览该自定义类型——和ASP.NET AJAX内建的客户端类型没什么区别。