MagicAjax装配

MagicAjax装配

2007-09-10 14:51

（一）版本      官方网站： http://www.magicajax.net/      下载：      .NET 1.1 binary release      .NET 2.0 binary release      Source      最新版本： 0.2.2      支持： .net 1.1 / 2.0 （二）.NET下 安装      1. 下载dll文件      2. 在Vs.net中，添加到工具箱中：      （1）工具箱点鼠标右键，选“添加/移除项”      （2）产生一个选择框后，选“浏览”，找到要安装的 magicajax.DLL文件      （3）安装完成后，会在“net framework组件”选单中产生两个选项：      ajaxpanel和ajaxzone，选择它们（默认为选定）。      （4）然后到“工具框”中，可以看到多出了四个文件： AjaxPanel      这个是基本的异步通讯容器,你只要把以前需要PostBack的组件(比如按钮)放在这个Panel里就可以实现无刷新页面的效果了 AjaxZone      这个组件的作用主要是获取在一个回调(CallBack)陷入中的状态,说明书上说使用这个组件可以稍稍提高服务器的响应速度. ClientEventTrigger      捕获一个客户端事件的触发器,需要注意的是,需要把它的事件名称与客户端触发的事件名称对应起来,并且ControlID属性必须和发布事件的客户端的属性吻合. KeyClientEventWrapper      这个是客户端事件的捕获器,用来捕获客户端激发的事件,比如点击click,聚焦forcus等等.      3.MagicAjax的压缩包里还附有两个js的脚本文件，一个是AjaxCallObject.js，一个是WebParts.js。前者是负责MagicAjax的普通事务的客户端表现的，后者则是专门针对WebParts的脚本。将两者都Copy到你的主要存放JS的目录下。以我的solution为例，我将此二者 Copy 到 站点根目录下的 script 文件夹里存放。 （三）配置      在工程的web.config里添加下面几处配置:      首先，在web.config的<configSections></configSections>里创建如下的标签： <section name="magicAjax" type="MagicAjax.Configuration.MagicAjaxSectionHandler, MagicAjax"/> 如果你的web.config 里没有<configSections></configSections> 请copy下面的片断，并确保它们是存放在<configuration></configruation>里的 <!--**************************************************--> <configSections>     <section name="magicAjax"     type="MagicAjax.Configuration.MagicAjaxSectionHandler, MagicAjax"/> </configSections> <!--**************************************************--> 下一步，在<configure></configure>标签里创建如下的内容 <magicAjax   scriptPath="~/script"   outputCompareMode="HashCode"   tracing="false">    <pageStore     mode="NoStore"     unloadStoredPage="false"     cacheTimeout="5"     maxConcurrentPages="5"     maxPagesLimitAlert="true"    /> </magicAjax> 参数解释如下： /*********************************************************/ MagicAjax 一.scriptPath 我们刚才提到的那两个脚本的存放路径，这个参数在设置的时候以~/ ，也就是站点的根目录作为一个出发点。比如，你要设置magicajax的js脚本到站点的根目录的blog下的script里，则写成 ~/blog/script。其余情况大家自己推理~ 二.outputCompareMode 脚本输出时的比较模式 有三种方式 FullHtml、HashCode、MD5 HashCode即可。具体的细节将在后面的章节里讲述。 三. tracing 是否跟踪如果设置为true的话，则在每次响应Ajax请求的时候会弹出一个alert来显示具体要加载的脚本 仅用于调试 /*********************************************************/ PageStore 用于配置Ajax的js脚本的缓存的标签 一.mode Page 对象存储的模式有三种方式 NoStore、Session、Cache。 NoStore，将不会缓存Page 对象 Session，将会把Page 对象存储到站点的Session里 Cache，将会把Page 对象存储到站点的Cache里。 二.unloadStoredPage 是否在Page的Unload对象里清除掉建立的Page 对象的Cache或者Session。一般都设置为false。 三.cacheTimeout Cache的过期时间以分钟为单位 四.maxConcurrentPages 同一个页面可以缓存的Page 对象的数量 一般为5 五.maxPagesLimitAlert 是否对达到最大缓存数进行警告 一般为 false 为什么要缓存页面对象，我们将在以后的章节里解释 /*********************************************************/ 最后一步，在<System.Web></System.Web>标签的 下级标签 <httpModules> </httpModules>里创建 <add name="MagicAjax" type="MagicAjax.MagicAjaxModule, MagicAjax" /> 如果你的<System.Web></System.Web>里没有<httpModules></httpModules> 请复制以下标签到你的<System.Web></System.Web>里 <httpModules> <add name="MagicAjax" type="MagicAjax.MagicAjaxModule, MagicAjax" /> </httpModules> 以上就是配置的步骤了。 配置完毕以后，你就可以安心地使用MagicAjax了~~