附錄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內建的用戶端類型沒什麼區別。