Community Server2.0专注细节一   邮件提醒按钮实现(上)

                                                                                                     作者: ugoer,  2006-3-9

在去年的CS1.x专题中,我用了大部分的时间去讨论CS底层的结构与运行机制.在接下来的CS2.0系列文章中我将专著细节.来分析CS2.0的一些部件的实现.

CS1.0与2.0有些变化,但是运行机制变化不大,变化的只是细节与增加的功能.

细节的第一篇,我们从一个按钮开始说起:

上面的“邮件提醒”按钮是在CS2.0论坛模块里的一个帖子左上角出现的。该按钮不是一般的按钮，有图片并且还有文字(文字不是图片中的一部分那么简单，文字会根据xml的资源文件的不同而替换不同的语言)，另外点击按钮还会通过Ajax回调一个服务器端方法，实现无刷新操作。

首先要明白的是，该按钮不是继承自Button，而是一个自定义控件。在CommunityServer.Controls项目，找到Utility文件夹下的ThreadSubscribeLinkButton.cs类。这就是该按钮的实现了。

public class ThreadSubscribeLinkButton : HtmlAnchor, ITrackedThread

该Button是继承了HtmlAnchor(就是HTML 的<a>)与 ITrackedThread。

ITrackedThread接口定义很简单：

public interface ITrackedThread

    {

        bool IsTracked { get;set;}

        int ThreadID { get;set;}

        bool Visible { get;set;}

    }

三个属性，分别是“是否已经跟踪”、“被跟踪的线索ID”、“是否可见”  ，这里说明一下thread这个单词在CS 中的解释：首先，一个论坛下的一个Post(我们一般叫帖子)，发表后就会有一个thread，这个线索包括了Post本身，还包括针对该Post的回复等等。Post和其回复就形成了一个thread。

我们回到ThreadSubscribeLinkButton.cs类看一些重要的属性：

public virtual bool UseImages

public virtual string TrackingResourceName

public virtual string NotTrackingResourceName

public virtual string WorkingResourceName

由于CS是提供多种语言支持，所有想要替换按钮上的文字就需要这些属性了。同时，如果要显示在不同的操作状态，如：在处理的时候显示一个漏沙图标 ，还有在处理完成后要显示一个完成的图标 。这些都需要上述属性的支持。另外，我们可以看出这些属性是可以重写的。

接下来在类中还有几个重要的方法：

protected override void OnLoad(EventArgs e)

这是最早激发的一个事件实现，在CreateChildControls之前。在这里我们可以看到为该类为页面注册了一个Ajax方法：

AjaxManager.Register(this,this.GetType().Name,true,AjaxDebug.None);

(关于Ajax类下次细节分析会做说明)

protected override void CreateChildControls()

在OnLoad之后就建立控件内容，内容主要包括一些js脚本的，并且根据IsTracked的值判断按钮应该显示的文字和图片。

protected override void OnPreRender(EventArgs e)

在建立控件内容后，就触发预呈现的OnPreRender事件。在该方法下，主要根据UseImages的值判断调用下面两个方法中的哪一个。

private void BuildCallbackScript()

private void BuildCallbackScriptWithImages()

这两个私有方法，构造Ajax回调的脚本。

[AjaxMethod(IncludeControlValuesWithCallBack=false)]

public bool ToggleEmailReplies(int threadID)

这是Ajax回调的方法，也就是说当点击按钮后，会通过js 通过xmlhttp调用该方法。

ThreadTracking.ReverseThreadTrackingOptions(threadID, context.User.UserID);

通过上面的调用，最终把值保存到数据库。ToggleEmailReplies方法最后返回一个bool变量，客户端的js脚本就会根据这个bool值变化按钮的文字与图片。