开发ASP.NET Atlas服务器端Extender控件—编写服务器端Extender & Dfl_[Asp.Net教程]
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基类,其中定义的是客户端属性值与服务器端属性值之间的映射关系。同时,TargetControlPropertiesBase基类以及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的定义前面加上了三个属性:
DefaultValue:设定这个属性的默认值。
IDReferenceProperty:指定这个属性中只能存放某一特定类型的控件的ID。
RequiredProperty:指定这个属性是必须的。
其他的几个属性您可以参考随后提供的源文件。
然后看一下ValidateUserNameExtender.cs文件,主要部分如下:
[Designer(typeof(ValidateUserNameDesigner))]
[ClientScriptResource("Dflying", "ValidateUserNameBehavior", "Dflying.Atlas.ControlTookit.ValidateUserName.ValidateUserNameBehavior.js")]
[RequiredScript(typeof(ValidateUserNameExtender))]
public class ValidateUserNameExtender : ExtenderControlBase
{
}
其中我们的ValidateUserNameExtender继承于ExtenderControlBase基类,得到一些共有的操作。并且在类上应用了三个属性:
Designer:指定这个Extender的设计器(用于提供设计期支持)的类名。
ClientScriptResource:指定生成客户端Atlas XML脚本所需要的信息。这里的Dflying和ValidateUserNameBehavior都要和前面的ValidateUserNameBehavior.js中定义的保持一致。
RequiredScript:指定客户端需要的脚本,这样Atlas会以axd文件的形式将ValidateUserNameBehavior.js链接到页面上。
最后是ValidateUserNameDesigner.cs文件,在这里您可以添加设计期的支持程序。让您的控件在Visual Studio中随着设定的属性值不同,显示样式也不同。这里为了简化,我就不添加设计期支持了。
值此为止,我们的Extender就写好了,来一次Release Build以后生成的DLL就可以直接拿来使用了。在下一篇文章中,我将演示在实际程序中应用这个Extender。
作者:Dflying Chen 来源:博客园