产品版本:RadControls for ASP.NET Ajax Q1 2009
Telerik 的控件实现 Ajax 的方式比 asp.net ajax 要简单些。有如下特点:
1. 不需要拖放很多 Update Panel,triggers.
只要在现有 webform 的底部加一个 RadAjaxManager,然后点 "Configure Ajax Manager",在其中配置更新关系即可。其中可以配置多个更新的设置,每一个设置是如下结构:
发起控件(一个)—— 被更新的控件(多个)
2. 配置 ajax callback 的方式很简单,容易理清页面上控件的触发-更新关系。
如1所说,生成的控件代码如下:
telerik:RadAjaxManager@H_301_16@
ID@H_301_16@
="RadAjaxManager1"@H_301_16@
runat@H_301_16@
="server"@H_301_16@
>@H_301_16@
@H_301_16@
AjaxSettings@H_301_16@
telerik:AjaxSetting@H_301_16@
AjaxControlID@H_301_16@
="Button1"@H_301_16@
UpdatedControls@H_301_16@
telerik:AjaxUpdatedControl@H_301_16@
ControlID@H_301_16@
="Label1"@H_301_16@
@H_301_16@
/>@H_301_16@
@H_301_16@
telerik:AjaxSetting@H_301_16@
telerik:RadAjaxManager@H_301_16@
>@H_301_16@
当然,要记得在页面首部放一个
和 asp.net ajax 类似的,它也有一个 RadAjaxManagerProxy 控件,用于在 User Control 或Content Page (master page 的使用场景)中使用。
RadAjax 的实现原理是通过将 PostBack 截获,转换为 ajaxcallback 来实现,在得到结果后,仅更新在上述配置中需要更新的那些目标控件。
因此对于一些默认不自动 PostBack 的控件,如果要让其能够触发 ajax callback,必须设置 AutoPostBack="True",才能作为触发控件使用。比如 CheckBox,TextBox 等。
常用的调试手段:如果 ajax callback 出错,首先想到的是将这个触发控件的 EnableAjax 属性设为 false,这样就恢复了一般的 PostBack 模式,可以查看到详细的错误信息。
另外还有两个 ajax 相关的控件:
1. RadAjaxPanel: 这个是 asp.net ajax UpdatePanel 控件的代替品,自动捕获其中的 PostBack 并转化为 ajax callback.
2. RadAjaxLoadingPanel: 用来显示一些 loading 的等待信息。
在服务器端添加控件更新设置:
RadAjaxManager1.AjaxSettings.AddAjaxSetting(,);
RadAjaxManager1.AjaxSettings.AddAjaxSetting(,, or null if none);
注意:此方法可以在 Page_Load 或 Page_PreRender 中调用。不能在 Page_Init 中调用,因为此时 AjaxManager 还没被创建。
客户端用 js 代码控制 RadAjaxManager 更新:
$find("").ajaxRequest(arguments);
该函数在服务器端会触发 AjaxRequest 事件,可以通过订阅该事件来处理请求。
ajaxRequestWithTarget(eventTarget,eventArguments) 函数可用来模拟其他控件发送 PostBack 或 ajax callback.
__doPostBack(eventTarget,eventArguments)
或
$find("").ajaxRequestWithTarget(eventTarget,eventArguments);
该函数在服务器端可通过对应的 event handler 来处理,如 Button1_Click.
在 UserControl 中,应该使用 RadAjaxManagerProxy 而不是 RadAjaxManager 控件。
但如果需要获得当前页面所包含的 RadAjaxManager,则也可以用 RadAjaxManager.GetCurrent() 来取得。如果不存在则返回 null.
RadAjaxManager.GetCurrent(Page);
例子:
telerik:RadCodeBlock@H_301_16@
="RadCodeBlock1"@H_301_16@
script@H_301_16@
type@H_301_16@
="text/javascript"@H_301_16@
@H_301_16@
function@H_301_16@
myUserControlClickHandler()
{
$find(@H_301_16@
"@H_301_16@
@H_301_16@
).ajaxRequest(@H_301_16@
content@H_301_16@
);
}
@H_301_16@
script@H_301_16@
telerik:RadCodeBlock@H_301_16@
复杂些的应用场景:
GridView 中的某些按钮要求能触发 ajax callback,而另一些则保持原有的 PostBack 行为。
解决办法:
在 GridView 的RowCreated 事件中,处理 DataRow 的 PreRender 事件,在 PreRender 事件处理函数中找到需要触发 ajax callback 的按钮,用 RadAjaxManager.AddAjaxSetting() 方法动态注册之。
注意:不要混用 RadAjaxPanel 和 RadAjaxManager. 如果一个控件被包含在 RadAjaxPanel 中,同时又是 RadAjaxManager 里注册的一个触发控件,则 Manager 中的设置不会起作用。
Q: 设置要被更新的控件被换行显示了?
A: RadAjaxManager 对设置的更新目标控件自动添加 UpdatePanel,而该 panel 的默认布局方式是 block. 可以设置成 inline 来阻止其换行,破坏布局。代码如下:
="server"@H_301_16@
UpdatePanelsRenderMode="Inline"@H_301_16@@H_301_16@@H_301_16@
="RadGrid1"@H_301_16@
="RadGrid1"@H_301_16@
="Label2"@H_301_16@
RadAjaxPanel 的目的是为了更新其中的内容,如果要触发其外部某些控件的更新,一般最好用 RadAjaxManager 来实现。但不用 RadAjaxManager 也是可以的。办法是通过 ResponseScripts 方法添加客户端的脚本去触发其他控件的更新。例子如下:
ASPX:
asp:ScriptManager@H_301_16@
="ScriptManager"@H_301_16@
h3@H_301_16@
Panel1@H_301_16@
telerik:RadAjaxPanel@H_301_16@
="RadAjaxPanel1"@H_301_16@
asp:Button@H_301_16@
="btnIncrease"@H_301_16@
OnClick@H_301_16@
="btnIncrease_Click"@H_301_16@
Text@H_301_16@
="Increase"@H_301_16@
asp:Button@H_301_16@
asp:Label@H_301_16@
0@H_301_16@
asp:Label@H_301_16@
asp:TextBox@H_301_16@
="TextBox1"@H_301_16@
="0"@H_301_16@
>@H_301_16@
asp:TextBox@H_301_16@
telerik:RadAjaxPanel@H_301_16@
Panel2@H_301_16@
="RadAjaxPanel2"@H_301_16@
="btnDecrease"@H_301_16@
="btnDecrease_Click"@H_301_16@
="Decrease"@H_301_16@
="TextBox2"@H_301_16@
Code behind:
protected@H_301_16@
void@H_301_16@
Page_PreRender(@H_301_16@
object@H_301_16@
sender,EventArgse)
{
@H_301_16@
if@H_301_16@
(RadAjaxPanel1.IsAjaxRequest@H_301_16@
||@H_301_16@
RadAjaxPanel2.IsAjaxRequest)
{
TextBox1.Text@H_301_16@
=@H_301_16@
Label1.Text@H_301_16@
TextBox2.Text@H_301_16@
Label2.Text@H_301_16@
Count.ToString();
}
}
@H_301_16@
public@H_301_16@
int@H_301_16@
Count
{
@H_301_16@
get@H_301_16@
{
@H_301_16@
return@H_301_16@
this@H_301_16@
.ViewState[@H_301_16@
"@H_301_16@
Count@H_301_16@
"@H_301_16@
]@H_301_16@
==@H_301_16@
null@H_301_16@
?@H_301_16@
@H_301_16@
0@H_301_16@
:(@H_301_16@
)@H_301_16@
];
}
@H_301_16@
set@H_301_16@
value;
}
}
@H_301_16@
btnIncrease_Click(@H_301_16@
301_16@
++@H_301_16@
;
RadAjaxPanel1.ResponseScripts.Add(String.Format(@H_301_16@
$find('{0}').ajaxRequest();@H_301_16@
,RadAjaxPanel2.ClientID));
}
@H_301_16@
btnDecrease_Click(@H_301_16@
--@H_301_16@
;
RadAjaxPanel2.ResponseScripts.Add(String.Format(@H_301_16@
301_16@
在 UserControl / Content page 里处理主页面的 RadAjaxManager 的事件(客户端事件、服务端事件都能订阅)的例子:
Page_Load(@H_301_16@
301_16@
RadAjaxManager.GetCurrent(Page);
manager.ClientEvents.OnRequestStart@H_301_16@
onRequestStart@H_301_16@
;
manager.ClientEvents.OnResponseEnd@H_301_16@
onResponseEnd@H_301_16@
;
manager.AjaxRequest@H_301_16@
+=@H_301_16@
new@H_301_16@
RadAjaxControl.AjaxRequestDelegate(manager_AjaxRequest);
}
@H_301_16@
manager_AjaxRequest(@H_301_16@
301_16@
//@H_301_16@
handlethemanagerAjaxRequesteventhere@H_301_16@
}@H_301_16@
总结
如果觉得编程之家网站内容还不错,欢迎将编程之家网站推荐给程序员好友。
本图文内容来源于网友网络收集整理提供,作为学习参考使用,版权属于原作者。