开发ASP.NET Atlas服务器端Extender控件——编写服务器端Extender & Dflying近期动向

作者：Dflying Chen （http://dflying.cnblogs.com/）

PS：承蒙各位厚爱，在博客园中安家的两个月中我学到了不少东西，认识了许多朋友，且得到了好多机会。目前我有幸翻译一本Atlas的书：Foundations of Atlas: Rapid Ajax Development with ASP.NET 2.0，估计三个月后即可于人民邮电出版社并面世。所以这段时间比较忙，Blog也不能有前一段时间那么频繁的更新了，特此表示歉意。当然，欢迎朋友们继续来讨论Atlas的相关问题，我会尽力回答。

未来的两个月内，对于Foundations of Atlas的翻译，我希望能够精益求精，所以一定会有不少问题需要与各位朋友讨论，例如术语，翻译风格等等。在这里我预先感谢了！

在上一篇（请参考：开发ASP.NET Atlas服务器端Extender控件——编写客户端Behavior）中我们已经写好了客户端的Behavior。在本篇文章中，让我们将它包装起来作为服务器端控件运行。

首先来到ValidateUserNameProperties.cs文件，该类继承于TargetControlPropertiesBase<Control>基类，其中定义的是客户端属性值与服务器端属性值之间的映射关系。同时，TargetControlPropertiesBase<Control>基类以及Atlas Control Extender已经为您做好了产生客户端XML Script的工作，您只需要定义您的Behavior需要的属性即可。

应该加入CheckResultLabelID，ServiceName，MethodName，ValidMessage以及InvalidMessage五个属性。为了简单，我只举一个属性的例子

[DefaultValue("")]
[IDReferenceProperty(typeof(WebControl))]
[RequiredProperty()]
public string CheckResultLabelID
{
    get
    {
        return GetPropertyStringValue("CheckResultLabelID");
    }
    set
    {
        SetPropertyStringValue("CheckResultLabelID", value);
    }
}

 

其中CheckResultLabelID的定义前面加上了三个属性：

1. DefaultValue：设定这个属性的默认值。
2. IDReferenceProperty：指定这个属性中只能存放某一特定类型的控件的ID。
3. RequiredProperty：指定这个属性是必须的。

其他的几个属性您可以参考随后提供的源文件。

然后看一下ValidateUserNameExtender.cs文件，主要部分如下：

[Designer(typeof(ValidateUserNameDesigner))]
[ClientScriptResource("Dflying", "ValidateUserNameBehavior", "Dflying.Atlas.ControlTookit.ValidateUserName.ValidateUserNameBehavior.js")]
[RequiredScript(typeof(ValidateUserNameExtender))]
public class ValidateUserNameExtender : ExtenderControlBase<ValidateUserNameProperties, Control>
{
}

 

其中我们的ValidateUserNameExtender继承于ExtenderControlBase<ValidateUserNameProperties, Control>基类，得到一些共有的操作。并且在类上应用了三个属性：

1. Designer：指定这个Extender的设计器（用于提供设计期支持）的类名。
2. ClientScriptResource：指定生成客户端Atlas XML脚本所需要的信息。这里的Dflying和ValidateUserNameBehavior都要和前面的ValidateUserNameBehavior.js中定义的保持一致。
3. RequiredScript：指定客户端需要的脚本，这样Atlas会以axd文件的形式将ValidateUserNameBehavior.js链接到页面上。

最后是ValidateUserNameDesigner.cs文件，在这里您可以添加设计期的支持程序。让您的控件在Visual Studio中随着设定的属性值不同，显示样式也不同。这里为了简化，我就不添加设计期支持了。

值此为止，我们的Extender就写好了，来一次Release Build以后生成的DLL就可以直接拿来使用了。在下一篇文章中，我将演示在实际程序中应用这个Extender。