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