本章主要介绍DynamicPopulateExtender的使用方法。DynamicPopulateExtender提供了一种动态效果,能通过WebService或访问服务器端代码获取一段HTML文本,并替换掉目标控件上原来的内容。
第一步:建立AJAX Control Toolkit Website
为了方便解说,本例子只使用了很少的控件,包括:两个HtmlInputRadio控件,一个Panel控件和一个DynamicPopulateExtender组件。所有控件的设置如以下代码所示:
DynamicPopulateExtender的设置很简单,这里简单说明一下:TargetControlID是指目标控件的ID,这里是Panel1,说明运行后DynamicPopulateExtender会替换掉Panel1中的内容。ServiceMethod是指Web服务中的函数,该函数名是GetHtml,稍后我会给出它的代码。UpdatingCssClass是当DynamicPopulateExtender正在获取内容时Panel1所套用的CSS样式,这个属性能使Panel1的界面更友好而不只是变得一片空白。注意:还有一个很重要的属性是ServicePath,由于我没有新建WebService来写GetHtml函数,所以这里不需要指定,但如果大家需要调用单独的WebService文件时,这个属性是需要指定的,值是所调用的WebService的全名,例如:WebService.asmx。
设置完所有控件之后我们还要编写相关CSS样式。大家可以参考如下代码:
大家要注意一下以上两个CSS样式的使用位置。一个是Panel1正常状态时的CSS样式,另一个是读取数据时的CSS样式。
第二步:编写Javascript
在以上代码中我们能看到两个Radio都调用了一个叫updateContent的Js函数,现在我列出该函数的代码:
注意:以上代码调用了Ajax.net的JS函数库,因此该函数一定要放在<asp:ScriptManager/>标签以下,否则会抛异常。"dp1"是指DynamicPopulateExtender的BehaviorID属性,大家也可以把DynamicPopulateExtender的ID属性设为"dp1"而删掉BehaviorID属性,效果是一样的。
这段JS的意思是先找到DynamicPopulateExtender组件,然后执行它的populate方法。而Sys.Application.add_load就相当于body里的onload,有关Ajax.net的JS函数库在这里不再作详细解析,大家自行测试一下。
第三步:创建WebService
这里我们要创建GetHtml函数,为了方便我直接在页面文件上创建该函数,具体代码如下:
这段代码很简单,根据不同的参数返回一段话的中文版本或英文版本,为了让效果更明显,我让程序延迟了2秒再执行。
注意:GetHtml的参数名contextKey和参数的数量都 是不可修改的,它是AjaxControlToolkit的规定签名格式,因此DynamicPopulateExtender的 ServiceMethod属性只需要定义为GetHtml,而不需要填写参数。如果要修改该名称则必须重新编译AjaxControlToolkit的 Dll文件,否则会返回500错误。但GetHtml这个函数名则是可以随意更改的,大家一定要注意!
OK,运行,效果如下图:
选择“英文”后,Panel1进入Updating状态。
成功读取数据后Panel1又回到了正常状态。
结束:
本章主要介绍了DynamicPopulateExtender的使用方法。大家可以自行编写更复杂的WebService,让 DynamicPopulateExtender发挥更好的作用。同时再次提醒大家一定要注意AjaxControlToolkit的规定签名格式的问 题,不要随意更改指定参数名称和参数数量。