DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> JavaScript入門知識 >> AJAX入門 >> AJAX詳解
Atlas 入門第一篇:ScriptManager 控制項完全解析
編輯:AJAX詳解     

稍早我們談過微軟如何用 Atlas 來回應 Ajax 的潮流。簡單說,Atlas 是一個用來打造跨瀏覽器、跨平台 Ajax 應用的 ASP.NET 2.0 框架。微軟在四月社群技術預覽版(CTP)中宣告已準備好開放 go-live 授權,本文就從它的核心——ScriptManager 類別談起。

ScriptManager 負責什麼

ScriptManager 管理頁面上所有的 Atlas 元件。除此之外,它還負責三件事:處理部分頁面更新、產生客戶端腳本,以及讓你能透過代理物件從 JavaScript 呼叫 Web 服務方法。

每個使用 Atlas 元件的頁面只能有一個 ScriptManager。如果你用 ASP.NET 2.0 的 Master Page,把 ScriptManager 放在母版頁上,所有內容頁就都共用得到。

語法結構

<atlas:ScriptManager
    EnablePartialRendering="true|false"
    EnableScriptComponents="true|false"
    ID="string"
    runat="server">
  <Scripts>
    <atlas:ScriptReference
        Browser="browser reference"
        Path="script file path"
        ScriptName="script file name" />
  </Scripts>
  <Services>
    <atlas:ServiceReference
        GenerateProxy="true|false"
        Path="server path name"
        Type="type name" />
  </Services>
</atlas:ScriptManager>

EnablePartialRendering

是否啟用部分渲染。設為 true 時,非同步控制項的常規回發只會把增量變化送到用戶端,而不重繪整頁。

EnableScriptComponents

決定 Atlas 的哪些部分預設可在客戶端使用,涵蓋 UI 元件、行為、行為綁定與 XML Scripting 相關的腳本。設為 false 時,可在 ScriptReference 中逐一指定要下載的元件。

ScriptReference

放在 Scripts 元素內,用來加入不會自動包含的腳本。可用 Path 指定路徑,用 Browser 指定適用瀏覽器。Atlas 有些預設不送出的腳本(如 AtlasUIDragDrop、AtlasUIGlitz、AtlasUIMap),就得靠 ScriptName 補上。

ServiceReference

用來宣告頁面腳本要使用的 Web 服務。GenerateProxy 可暫時關閉為服務產生代理物件。

一個完整例子

<%@ Page Language="C#" %>
<html xmlns="https://www.w3.org/1999/xhtml">
<head id="hd" runat="server">
  <title>TR Sample</title>
  <atlas:ScriptManager ID="scriptManager" runat="server"
      EnablePartialRendering="false"
      EnableScriptComponents="false">
    <Services>
      <atlas:ServiceReference Path="testService.asmx" GenerateProxy="true" />
    </Services>
    <Scripts>
      <atlas:ScriptReference Path="AtlasRuntime.js" />
    </Scripts>
  </atlas:ScriptManager>
  <script type="text/javascript">
    function callWebService() {
        testService.displayTime("request data", handleResponse);
    }
    function handleResponse(response) {
        alert("Server response: " + response);
    }
  </script>
</head>
<body>
  <form id="frmTR" runat="server">
    <div><input type="button" onclick="callWebService()"
        value="Call Web Service" /></div>
  </form>
</body>
</html>

這頁宣告了服務參考,部分頁面渲染與額外腳本庫都關閉,只保留隨 Atlas 安裝的 AtlasRuntime.js 以維持基本功能。對應的服務端:

<%@ WebService Language="C#" Class="testService" %>
using System;
using System.Web.Services;

[WebService(Namespace = "https://tempuri.org/")]
[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
public class testService : System.Web.Services.WebService {
    [WebMethod]
    public string displayTime() {
        return DateTime.Now.ToString();
    }
}

ScriptManagerProxy:繞過「只能有一個」的限制

如果 ScriptManager 已經在母版頁宣告,而某個內容頁需要額外的腳本或服務參考,就用 ScriptManagerProxy:

<atlas:ScriptManagerProxy runat="server" id="smProxy">
</atlas:ScriptManagerProxy>

它的語法與 ScriptManager 相同,只是定位在「補充」而非「取代」。

隨附的現成控制項

除了 ScriptManager,Atlas 也提供了幾個幾乎不用寫程式就能加效果的元件:

AutoCompleteExtender:擴充文字方塊,提供自動完成建議(資料由 Web 服務提供)。
DragOverlayExtender:把伺服器控制項變成可隨滑鼠與鍵盤移動的浮動物件。
ProfileScriptService:建立可從用戶端存取 ASP.NET 使用者設定檔的元件。
TimerControl:建立客戶端計時器,依固定間隔回發。

DragOverlayExtender 是最容易上手的一個,只要把目標控制項的 ID 指派給 TargetControlID 即可:

<atlas:ScriptManager ID="scriptManager" runat="server"
    EnablePartialRendering="false" EnableScriptComponents="true" />
...
<asp:Image runat="server" ImageUrl="~/testimage.jpg" id="imgTest" />
<atlas:DragOverlayExtender ID="doe" runat="server">
  <atlas:DragOverlayProperties Enabled="True" TargetControlID="imgTest" />
</atlas:DragOverlayExtender>

其他值得知道的事

部署上不需要管理員介入:把 Microsoft.Web.Atlas.dll 複製到專案的 bin 目錄,再把 ScriptLibrary 下的 .js 檔複製進專案即可。

雖然掛著微軟的名字,Atlas 並不綁特定瀏覽器,控制項的樣式全部以 CSS 實作,也能依瀏覽器差異輸出不同內容。至於「Atlas 只是把開發者從 Firefox 與 Opera 拉回來的策略」這種說法,筆者的看法比較務實:工具的價值在於能不能解決客戶的問題,到目前為止,Atlas 展現的東西令人滿意。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved