DynamicPopulate 示例

概述:
DynamicPopulate 是一个简单的 ASP.Net AJAX 控件,它的主要职责是负责 JavaScript 和 Web Service 进行通信。 类似上述的例子,在 Java Script 和 Web Service 进行通信以后,它将替换调页面中的一部分 Html 内容。

DynamicPopulate 在类似功能里起到的最大作用就是将本需要大量的 Java Script 代码进行了简化

属性:

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
posted on 2009-08-04 16:25  晴天1848  阅读(232)  评论(0)    收藏  举报