AjaxControltoolkit學習筆記—DynamicPopulate使用詳解 (asp.net C#)

DynamicPopulate 是一個簡單的 ASP.Net AJAX 控件，它的主要職責是負責 JavaScript 和 Web Service 進行通信。 類似上述的例子，在 Java Script 和 Web Service 進行通信以後，它將替換調頁面中的一部分 Html 內容。

DynamicPopulate 在類似功能裏起到的最大作用就是將本需要大量的 Java Script 代碼進行了簡化。

DynamicPopulate 屬性

DynamicPopulate 控件屬性將被初始化如下面的示例代碼所示，斜體 屬性爲可選屬性 其中，屬性 CustomScript 或者 ServiceMethod 必須指定一個。

<ajaxToolkit:DynamicPopulateExtender ID="dp" runat="server"

    TargetControlID="Panel1" 
ClearContentsDuringUpdate
="true" 
PopulateTriggerControlID
="Label1" 
ServiceMethod
="GetHtml" 
UpdatingCssClass
="dynamicPopulate_Updating" />

• TargetControlID - 用於顯示更新從 Web Service 取回的 Html 元素控件 ID
• ClearContentsDuringUpdate - 默認是 True，指定當向 Web Service 發送獲取指令的時候是否清空 TargetControlID 內容
• ServicePath - 指定 Web Service 的路徑地址，當所需要的 Web Service 方法爲當前頁時，可以將此屬性指定爲空。
• ServiceMethod - 指定需要的 Web Service 方法，該方法需要採用下列的函數簽名格式：

  [System.Web.Services.WebMethod]
  
  [System.Web.Script.Services.ScriptMethod]
  
  string DynamicPopulateMethod(string contextKey) { ... }

  注意：

  ---

  你可以替換上面示例中的方法名稱，DynamicPopulateMethod 爲任何你想要的方法名，但是返回值和參數列表需要保持完全一致。
• PopulateTriggerControlID - 這裏可以指定一個觸發從 Web Service 獲得方法並更新 TargetControlID 的控件 ID，當這個控件被頁面用戶點擊的時候， 將觸發該更新事件
• UpdatingCssClass - 當正在進行 Web Service 通信時顯示 Css 樣式
• CustomScript - 一個可自定的 Script 腳本。它可以用於替換指定的 Web Service 方法。
• ContextKey - 一個可用於傳入 Web Service 方法的參數，該參數將用於 Web Service 根據客戶端的不同操作產生相應的不同的返回結果
• CacheDynamicResults - 是否在 Web Service 調用的時候採用緩存機制，默認是 False