如果你的站台用了 Atlas Control Toolkit,要遷移到 ASP.NET AJAX 1.0 其實不難。最大的變化是移除了 TargetProperties 這個屬性集合物件,其餘都是機械性的修改。
Toolkit 的組件名稱改了,先把 Web 站台的參考從 AtlasControlToolkit 換成 AjaxControlToolkit,並更新所有頁面的 Register 指示字。
原本:
<%@ Register
Assembly="AtlasControlToolkit"
Namespace="AtlasControlToolkit"
TagPrefix="atlasToolkit" %>
改為:
<%@ Register
Assembly="AjaxControlToolkit"
Namespace="AjaxControlToolkit"
TagPrefix="AjaxToolkit" %>
新版的擴充元件移除了 TargetProperties,每個屬性現在直接定義在 Extender 上。因此原本每一個屬性物件,都要對應成一個獨立的 Extender 實例。
原本一個 Extender 帶兩個屬性物件:
<atlasToolkit:ConfirmButtonExtender ID="cbe1" runat="server">
<atlasToolkit:ConfirmButtonProperties
TargetControlID="LinkButton1"
ConfirmText="Delete Item?" />
<atlasToolkit:ConfirmButtonProperties
TargetControlID="LinkButton2"
ConfirmText="Update Item?" />
</atlasToolkit:ConfirmButtonExtender>
要拆成兩個 Extender:
<AjaxToolkit:ConfirmButtonExtender ID="cbe1" runat="server" /> <AjaxToolkit:ConfirmButtonExtender ID="cbe2" runat="server" />
把原本寫在屬性物件裡的設定,直接搬成 Extender 的屬性:
<AjaxToolkit:ConfirmButtonExtender
ID="cbe1"
runat="server"
TargetControlID="LinkButton1"
ConfirmText="Delete Item?" />
<AjaxToolkit:ConfirmButtonExtender
ID="cbe2"
runat="server"
TargetControlID="LinkButton2"
ConfirmText="Update Item?" />
如果你在屬性物件中指定了組件的 ID,以便從 JavaScript 取得該行為物件,請在 Extender 中把它改名為 BehaviorID,並改用 $find() 抓取。
原本:
<atlasToolkit:ConfirmButtonExtender ID="cbe1" runat="server">
<atlasToolkit:ConfirmButtonProperties
ID="confirmBehavior1"
TargetControlID="LinkButton1"
ConfirmText="Delete?" />
</atlasToolkit:ConfirmButtonExtender>
<script type="text/javascript">
function DoSomething() {
var b = $object("confirmBehavior1");
b.confirm();
}
</script>
改為:
<AjaxToolkit:ConfirmButtonExtender
ID="cbe1"
BehaviorID="confirmBehavior1"
runat="server"
TargetControlID="LinkButton1"
ConfirmText="Delete?" />
<script type="text/javascript">
function DoSomething() {
var b = $find("confirmBehavior1");
b.confirm();
}
</script>
要注意 Extender 本身的 ID(cbe1)與 BehaviorID(confirmBehavior1)是兩個不同用途的識別碼:前者是伺服器控制項的 ID,後者才是客戶端行為物件的識別碼。
依序做完這四步,頁面就能在新版下運作。實務上建議先在一個副本上試改,確認所有 Toolkit 控制項都換過、頁面實際操作無誤,再更新正式站台。