十二．DynamicPopulate

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