要用微軟那套 Ajax 控制項,得先把兩樣東西裝齊:ASP.NET Ajax Extensions 與 AjaxControlToolkit。
下載位址:https://asp.net/ajax/downloads/default.aspx
執行 ASPAJaxExtSetup.msi 安裝更新後,系統盤(以下以 C 盤為例)會多出一個目錄:
C:\Program Files\Microsoft asp.NET\ASP.NET 2.0 Ajax Extensions\v1.0.61025
裝好之後,你就能建立 ASP.NET Ajax-Enabled Web Site 站點了——這其實就是一個 Ajax.NET 網站的範本。但此時還用不了微軟提供的那些 Ajax 控制項,得再往下走。
下載 AjaxControlToolkit。官方提供兩個版本,一個含原始碼、一個不含,建議選含原始碼的版本。下載後解壓到:
C:\Program Files\Microsoft asp.NET\ASP.NET 2.0 Ajax Extensions\v1.0.61025\AjaxControlToolkit\
雙擊執行 AjaxControlToolkit.sln,用 VS2005 開啟這個解決方案,編譯 TemplateVSI 專案;接著把 SampleWebSite\Bin 底下產生的 AjaxControlToolkit.dll 與 AjaxControlToolkit.pdb 複製到:
C:\Program Files\Microsoft ASP.NET\ASP.NET 2.0 Ajax Extensions\v1.0.61025\AjaxControlToolkit\Binaries
這一步是關鍵:DLL 放進 Binaries 之後,VS2005 才能在工具箱裡認出這批控制項。
新增一個 Ajax Control Toolkit Web Site 類型的 Web 專案,在工具箱上新增一個索引標籤(例如命名為 AjaxControlToolkit),在該標籤上按右鍵選擇「選擇項目」→「瀏覽」,找到剛才複製過去的 AjaxControlToolkit.dll 並加入。
完成之後,工具箱裡就會列出整套控制項,可以直接拖進頁面使用了。
第一,正式部署到伺服器時,記得把 AjaxControlToolkit.dll 一併放進專案的 bin 目錄,否則會出現組件載入失敗的錯誤——而這類錯誤通常還伴隨「找不到資源檔」的訊息,原因往往就是少了衛星組件。
第二,若你的專案需要 Microsoft.Web.Preview.dll,則要另外安裝 ASP.NET Ajax Futures CTP;兩者的版本必須與你安裝的 Extensions 相容,混搭不同月份的 CTP 是常見的踩坑來源。