Anthem.net试用手记之使用篇

Anthem.net试用手记之使用篇。

http://www.cnblogs.com/aspxcn/archive/2006/11/29/576221.html

 

这几天熟悉 Anthem.net 框架的过程中 , 最大感觉就是如果熟悉 Asp.net ajax 框架 , 那么要上手 Anthem.net 是非常容易的 , 为什么这样说 ? 那我们就要从 Anthem.net 的使用说起 , 首先不用像 asp.net ajax 那样在原来项目中的 web.config 加入一大堆定义 , 仅仅需要在页面加入定义来引用 Anthem.net, 语句如下 :

<%@ Register TagPrefix="anthem" Namespace="Anthem" Assembly="Anthem" %>

简单地说就是引入一个 Anthem 的自定义控件而已 , 如果页面比较多 , 也可以直接在 web.config / / / 中定义：

< add tagPrefix ="anthem" namespace ="Anthem" assembly ="Anthem"/>

 之后我们要为原有 Asp.net 项目实现 ajax 效果 , 使用 Anthem.net 主要有如下几种方式 :

 1、  Anthem:Panel 方式

Anthem.net 为我们提供了一个叫 anthem:panel 控件，该控件继承原有 ASP:Panel 控件的所有属性及方法并增加异步回调及刷新的功能，不过与其它同样是由 Anthem.net 提供继承并增加异步回调及刷新的控件有点不同， Anthem:Panel 与 Asp.net ajax 的 updatepanel 控件有点相似，只需将原有项目的 Asp.net 控件放进 Anthem:Panel 内，即可简单地实现 ajax 效果，其作用基本与 asp.net ajax updatpanel 是一样的，只不过设置上有少少不同，请看下面的对比：

作用	Asp:Updatepanel	Anthem:Panel
任何控件引发的回送均将更新该控件。	UpdateMode=Always	AutoUpdateAfterCallBack=true
只有服务器端调用相应方法才会引发更新该控件。	UpdateMode=Conditional, 服务端调用Update 方法	AutoUpdateAfterCallBack=False, 服务端设置 UpdateAfterCallBack=true

是不是有点“孪生兄弟”的味道？

 2、  AutoUpdateAfterCallBack 方式
将所有由 Anthem.net 提供的控件设置为 AutoUpdateAfterCallBack=true 即可实现 ajax, 像原来的 改为 即可实现 GridView 的异步回调及刷新，而且原有 GridView 里面的自定义模版也完全不需要更改，比如模版里带了一个 asp:linkbutton 控件，那么也无需改为 anthem:linkbutton 也能正常实现无刷新回调。

3、  UpdateAfterCallBack 方式
如果觉得直接设置控件为 AutoUpdateAfterCallBack=true 不够细致化，那么也可以直接在后台方法中通过设置相应控件为 UpdateAfterCallBack=true 来实现无刷新回调，其实现方式有点类似调用 updatepanel 的 update 方法。

页面：

< div >

     < anthem:Button  ID ="btnSetText"  runat ="server"  Text ="Set Text"  OnClick ="btnSetText_Click"   />

     < anthem:Label  ID ="lbText"  runat ="server"   />

div >

后台方法:

protected   void  btnSetText_Click( object  sender, EventArgs e)
{

    lbText.Text  =   " This text is set on server side. " ;

    lbText.UpdateAfterCallBack  =   true ;

}

4、  重写原有控件
使用 asp.net ajax 会发现，对于包含在 updatepanel 中的一些第三方控件会出现一些不兼容问题，在 Anthem.net 中也一样存在这个问题，但 Anthem.net 的优势就是开源，只要第三方控件也是开源的话，我们就可以重写控件使其直接实现无刷新回调功能，官方例子中已经有相关演示，我就不多说了，而且我也会在下一篇的实战篇中改造 FCKeditor 控件，使其成为名符其实的 FCKeditor For Anthem.net 控件！

 

另外， Anthem.net组件 下载地址http://sourceforge.net/projects/anthem-dot-net/