众所周知,UpdatePanel是通过Trigger来更新的。被设定为Trigger的控件在PostBack之后会被客户端所截获,并且使用XMLHttpRequest对象发送内容,然后服务器端由ScriptManager配合,改变Page对象的输出,最后得到部分刷新的效果。但是有时候我们可能需要使用JavaScript来刷新UpdatePanel,这时候就不太方便了。

  当然,我们又一个属于Workaround的方法,那就是使用JavaScript来模拟按钮的点击。我们往往会将一个按钮设为某个UpdatePanel的Trigger,然后在客户端模拟它的点击(我后面会提到,其实这是一个比较糟糕的做法,没有必要),使UpdatePanel进行更新。但是这样的做法实在太麻烦了些,也相当的不优雅。

  现在我们就来编写一个组件解决这个问题。这个组件的名字叫做JavaScriptUpdater,似乎取得不怎么样——我一直不擅长取名。

首先来定一个需求吧

  我们的目的,其实就是为了在客户端生成一个JavaScript代理,提供一个方法,调用它之后能够刷新页面。如果一个UpdatePanel的UpdateMode为Always,那么它一定会更新。如果需要更新UpdateMode为Conditional的UpdatePanel,就需要通过在页面中编写tag来设定哪些UpdatePanel也会被更新。我们需要尽可能的把编程工作变得最小。

  不如我们先考虑使用方式,我们编写的这个JavaScriptUpdater在页面中可以这样使用:

JavaScriptUpdater使用方式

<helper:JavaScriptUpdater runat="server" ID="Updater" MethodName="Refresh"ResolveUpdatePanel="OnResolveUpdatePanel" Enabled="True"><UpdatePanels><helper:UpdatePanel UpdatePanelID="UpdatePanel1" />...</UpdatePanels>
</helper:JavaScriptUpdater>

  JavaScriptUpdater有一个简单属性MethodName,表明了在客户端生成代理方法的名字。再上例中该属性为Refresh,表明我们会调用UpdatePanels.Refresh()方法进行UpdatePanel更新。UpdatePanels是一个集合属性,可以指定哪些UpdateMode为Conditional的UpdatePanel一同进行更新。如果某个UpdatePanelID没有找到的话,就会调用ResolveUpdatePanel事件,让用户来指定一个UpdatePanel。还有一个Enabled属性,用于控制该JavaScriptUpdater是否生效。

  一个页面里能够放置多个JavaScriptUpdater,这样可以生成多个JavaScript代理方法。这样的设定,应该已经足够用了。

实现JavaScriptUpdater

  自然,我们先定义最简单的两个类,UpdatePanelHelper.UpdatePanel类,和ResolveUpdatePanelEventArgs类。由于实在简单,就直接贴一下代码了:

UpdatePanel类

namespace UpdatePanelHelper
{public class UpdatePanel{private string _UpdatePanelID;public string UpdatePanelID{get { return _UpdatePanelID; }set { _UpdatePanelID = value; }}}
}

ResolveUpdatePanelEventArgs类

namespace UpdatePanelHelper
{public class ResolveUpdatePanelEventArgs : EventArgs{private string _ID = null;public string ID{get { return _ID; }}private System.Web.UI.UpdatePanel _UpdatePanel = null;public System.Web.UI.UpdatePanel UpdatePanel{get { return _UpdatePanel; }set { _UpdatePanel = value; }}public ResolveUpdatePanelEventArgs(string id){this._ID = id;}}
}

  然后开始考虑编写最关键的JavaScriptUpdater类。首先定义它的简单框架,如下:

JavaScriptUpdater控件的总体框架与属性定义

namespace UpdatePanelHelper
{[PersistChildren(false)][ParseChildren(true)][NonVisualControl]public class JavaScriptUpdater : Control{private bool initialized = false;private bool _Enabled = true;public bool Enabled{get{return this._Enabled;}set{if (this.initialized){throw new InvalidOperationException(                        "Cannot set the property after initialized.");}this._Enabled = value;}}private string _MethodName;public string MethodName{get{return this._MethodName;}set{if (this.initialized){throw new InvalidOperationException(                        "Cannot set the property after initialized.");}this._MethodName = value;}}public event EventHandler<ResolveUpdatePanelEventArgs> ResolveUpdatePanel;private List<UpdatePanel> _UpdatePanels = new List<UpdatePanel>();[PersistenceMode(PersistenceMode.InnerProperty)]public List<UpdatePanel> UpdatePanels{get{return _UpdatePanels;}}...}
}

  我们使用一个initialized变量来确保Enabled或MethodName属性只能在页面Init时进行修改。由于控件会在多个生命周期中进行操作,如果不做这样的限制,会让控制变得繁琐,容易出错。从下面的代码中会发现,我们会在响应页面的InitComplete事件时将initialized变量设为true。

  我们在这里实现JavaScript更新UpdatePanel的做法,和传统的方法异曲同工,只是我们这里将动态添加按钮,并且在这里我们使用LinkButton。我们将响应Page对象的Load事件,添加那个作为Trigger的LinkButton。如下:

动态添加LinkButton

private string clientButtonId = null;protected override void OnInit(EventArgs e)
{base.OnInit(e);this.Page.InitComplete += new EventHandler(Page_InitComplete);
}private void Page_InitComplete(object sender, EventArgs e)
{    this.initialized = true;if (this.Enabled){this.Page.Load += new EventHandler(Page_Load);this.Page.PreRenderComplete += new EventHandler(Page_PreRenderComplete);}
}private void Page_Load(object sender, EventArgs e)
{LinkButton button = new LinkButton();button.Text = "Update";button.ID = this.ID + "Button";button.Style[HtmlTextWriterStyle.Display] = "none";button.Click += new EventHandler(OnTrigger);this.Page.Form.Controls.Add(button);this.clientButtonId = button.UniqueID;ScriptManager.GetCurrent(this.Page).RegisterAsyncPostBackControl(button);
}

  我们在页面的Page_InitComplete事件中判断Enabled属性是否为true(这时Enabled属性已经不能修改了),如果Enabled为ture,则响应页面的Load事件,用于动态添加一个LinkButton。请注意,我们并不会将它的Visible属性设为False,否则它的HTML将不会出现在页面上。我们应该将它Style的display设为none,这样它既能在页面结构中出现,也不会显示出来。在添加了这个LinkButton之后,将会保留它的ClientID,并且找出当前页面的ScriptManager,调用RegisterAsyncPostBackControl方法,将这个LinkButton注册为异步刷新页面的控件。

  以前,我写给别人范例都是使用了一个Button作为Trigger,然后在客户端使用JavaScript对它进行点击。这其实不是很合理,比较好的做法其实使用LinkButton。要说明这个问题的原因,我们需要看一下LinkButton在页面中生成的HTML元素。很显然,这是个<a />,如下:

LinkButton生成的HTML

<a id="UpdaterButton" href="javascript:__doPostBack('UpdaterButton','')">Update</a>

  请注意它的href,它表明了点击该元素会执行这个JavaScript代码。发现了不?我们何必模拟元素的点击,我们直接调用__doPostBack函数不就行了?Cool!于是我们现在也可以轻易得出,在响应页面的PreRenderComplete事件时需要注册的Script脚本了。如下:

在PreRenderComplete事件中注册脚本

private const string BasicScripts =
@"if (!window.UpdatePanels) window.UpdatePanels = {};
UpdatePanels._createUpdateMethod = function(btnId)
{return function(){__doPostBack(btnId, '');}
}";private const string RegisterMethodTemplate = "\nUpdatePanels['{0}'] = UpdatePanels._createUpdateMethod('{1}');";private void Page_PreRenderComplete(object sender, EventArgs e)
{this.Page.ClientScript.RegisterClientScriptBlock(this.GetType(),"BasicScripts",JavaScriptUpdater.BasicScripts,true);this.Page.ClientScript.RegisterClientScriptBlock(this.GetType(),this.clientButtonId,String.Format(JavaScriptUpdater.RegisterMethodTemplate, this.MethodName, this.clientButtonId),true);
}

  首先会注册一些基础脚本,我们会使用相同的Type和Key参数,这样保证了这段代码只会被注册一次。在注册每个代理方法的脚本时,就会使用该脚本的clientButtonId作为key,保证了每段脚本都会被注册成功。顺便一提,我们在这里直接使用了Page的ClientScriptManager来注册脚本,保证了在异步更新UpdatePanel时,不会将脚本发送到客户端去。

  可能有朋友会出现疑惑,为什么我们需要在页面的PreRenderComplete事件中注册脚本呢?在页面的Load事件中一并注册了不可以吗?答案是,因为ScriptManager也是在这时候注册ASP.NET AJAX的基础脚本,我们现在这么做是为了保证了我们注册的脚本出现在ASP.NET AJAX的脚本之后。

  哦,原来如此……等一下,是否发觉我们现在的脚本与ASP.NET AJAX的基础脚本无关?没错,事实上我们这里的确可以方法页面的Load事件中注册,我现在这么做似乎只是一个习惯——或者说是为ASP.NET AJAX编写组件的一个模式——响应页面的PreRenderComplete事件,用于注册所需的脚本。

  大部分的工作已经完成了,我们只需要再响应那个LinkButton的Click事件即可。我们需要强制更新所有指定的UpdatePanel。代码如下,非常简单,就不多作解释了:

触发更新

private void OnTrigger(object sender, EventArgs e)
{if (this.Enabled){foreach (UpdatePanel panel in this.UpdatePanels){System.Web.UI.UpdatePanel updatePanel = this.FindUpdatePanel(panel.UpdatePanelID);if (updatePanel != null){updatePanel.Update();}}}
}private System.Web.UI.UpdatePanel FindUpdatePanel(string id)
{System.Web.UI.UpdatePanel result = null;if (id != null){result = this.NamingContainer.FindControl(id)as System.Web.UI.UpdatePanel;}if (result == null){ResolveUpdatePanelEventArgs e = new ResolveUpdatePanelEventArgs(id);this.OnResolveUpdatePanel(e);result = e.UpdatePanel;}return result;
}private void OnResolveUpdatePanel(ResolveUpdatePanelEventArgs e)
{if (this.ResolveUpdatePanel != null){this.ResolveUpdatePanel(this, e);}
}

使用JavaScriptUpdater

  JavaScriptUpdater非常简单,只需一个最简单的例子,大家就可以明白它的使用方式:

JavaScriptUpdater使用示例

<%@ Register Assembly="UpdatePanelHelper" Namespace="UpdatePanelHelper" TagPrefix="helper" %><asp:UpdatePanel ID="UpdatePanel1" runat="server" UpdateMode="Conditional"><ContentTemplate><%= DateTime.Now.ToString() %></ContentTemplate>
</asp:UpdatePanel><helper:JavaScriptUpdater runat="server" ID="Updater" MethodName="Refresh"><UpdatePanels><helper:UpdatePanel UpdatePanelID="UpdatePanel1" /></UpdatePanels>
</helper:JavaScriptUpdater><input type="button" onclick="UpdatePanels.Refresh()" value="Refresh" />

  点击最下方定义的按钮时,会调用UpdatePanels.Refresh()方法,于是则会更新UpdatePanel1。请注意,UpdatePanel1的UpdateMode为Conditional,我们是通过在JavaScriptUpdater中指定它,用于强制对它进行更新。我们再看一下它生成的JavaScript代码和HTML就会更加清楚它的实现方式了。如下:

在客户端生成的内容

<script type="text/javascript">if (!window.UpdatePanels) window.UpdatePanels = {};UpdatePanels._createUpdateMethod = function(btnId){return function(){__doPostBack(btnId, '');}}UpdatePanels['Refresh'] = UpdatePanels._createUpdateMethod('UpdaterButton');
</script>...<a id="UpdaterButton"href="javascript:__doPostBack('UpdaterButton','')"style="display:none;">Update</a>
 
《老赵点滴》

转载于:https://www.cnblogs.com/xfxr/archive/2009/06/27/1512350.html

编写组件,使用JavaScript更新UpdatePanel相关推荐

  1. 深入理解JavaScript系列(1):编写高质量JavaScript代码的基本要点

    才华横溢的Stoyan Stefanov,在他写的由O'Reilly初版的新书<JavaScript Patterns>(JavaScript模式)中,我想要是为我们的读者贡献其摘要,那会 ...

  2. 深入理解JavaScript系列(1):编写高质量JavaScript代码的基本要点(转)

    才华横溢的Stoyan Stefanov,在他写的由O'Reilly初版的新书<JavaScript Patterns>(JavaScript模式)中,我想要是为我们的读者贡献其摘要,那会 ...

  3. 编写高质量JavaScript代码绳之以法(The Essentials of Writing High Quality JavaScript)翻译...

    原文:The Essentials of Writing High Quality JavaScript 才华横溢的Stoyan Stefanov,在他写的由O'Reilly初版的新书<Java ...

  4. Kettle8.2脚本组件之javascript脚本

    Kettle8.2脚本组件之javascript脚本 一.相关说明 二.设计转换 三.转换配置 四.运行转换 五.结果查看 一.相关说明 脚本组件说明: 脚本就是直接通过程序代码完成一些复杂的操作. ...

  5. Firefox - 附加组件 - 扩展 - Firebug - 更新 - 1.2.0b15

    Firefox - 附加组件 - 扩展 - Firebug - 更新 - 1.2.0b15 * Suspend feature 禁用特性 * Display which tabs have fireb ...

  6. 单独组件_苹果已停止对macOS Big Sur 11.0.1版本macOS系统组件的单独更新

    从macOS Big Sur 11.0.1版本开始,苹果已停止提供其macOS系统组件的单独更新版本,但直到12月16日仍在为Catalina和Moojave版本提供支持. 过去,苹果为用户提供了单独 ...

  7. 编写自己的Javascript库-1

    通过编写自己的Javascript库来提高自己的Javascript水平. 今天先实现两个方法,以后边学习边编写. (function (){  window['SoftLin']={}  //等同于 ...

  8. 解决Vue循环中子组件不实时更新的问题

    解决Vue循环中子组件不实时更新的问题 参考文章: (1)解决Vue循环中子组件不实时更新的问题 (2)https://www.cnblogs.com/rever/p/10565042.html 备忘 ...

  9. 编写高质量javascript代码的基本要点

    javascript入门比较快,基础方面也比较简单,但如果想写出高质量的javascript代码也绝非易事,下图是在下整理的编写高质量javascript代码的基本要点,希望能够对各位有所帮助. 转载 ...

最新文章

  1. Delphi 与 DirectX 之 DelphiX(35): TDIB.Saturation();
  2. ESXI开启snmp协议方法
  3. 【Android 应用开发】Android 组件 位置坐标 属性 ( 组件位置属性 | 父容器坐标系坐标 | 窗口坐标系坐标 | 屏幕坐标系坐标 | 触摸坐标 )
  4. Webview中无法触发手势方法(ontouchevent,onfling...)的解决方法
  5. sql 如何查询上次的记录_学会SQL并不难,小白学习记录之五(多表查询)
  6. Android系统的手表adb抓取log日志
  7. orcl导入dmp语句_oracle中导入dmp数据注意事项
  8. vbs把excel文件另存为html,VBS实现将Excel表格保存为txt文本
  9. 进程间通信 - 整理
  10. mapreduce 多种输入
  11. 分子重构技术_4. 串珠模型重构
  12. 海康视频监控解决方案
  13. python竖线_python 读取竖线分隔符的文本方法
  14. 16种互联网产品盈利模式介绍
  15. python 视频加字幕_Python追风者之视频编辑moviepy
  16. Ubuntu20.04LTS 安装QQ 微信 钉钉 最简单,最好用的方式!
  17. E:无法定位软件包 zlib-devel
  18. 南开大学计算机本科论文,南开大学本科(论文)模板.doc
  19. JS控制字体大小中、设为首页、收藏本站功能、超链接去掉颜色
  20. EWM常规开发知识汇总

热门文章

  1. python执行效果_python:执行一个命令行N次
  2. 运用div css和java_如何将css应用于div模式
  3. Java头文件找出循环依赖_Node.js 如何找出循环依赖的文件?如何解决循环依赖问题?...
  4. 高考计算机专业最低分数线是多少,2021最低多少分可以稳上二本 高考二本分数线是多少...
  5. pytorch 对抗样本_【天池大赛】通用目标检测的对抗攻击方法一览
  6. Python使用管道实现进程间数据传递
  7. Java共享字符串_JAVA-字符串的构建
  8. mysql 怎么算第二天_mysql 第二天
  9. c语言环境变量win10,设置系统环境变量是干嘛的?教你在哪设置win10环境变量
  10. vxworks linux 多线程api,vxWorks操作系统的多线程实现研究