随笔- 313  评论- 12176  文章- 1 

开发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需要的属性即可。

应该加入CheckResultLabelIDServiceNameMethodNameValidMessage以及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脚本所需要的信息。这里的DflyingValidateUserNameBehavior都要和前面的ValidateUserNameBehavior.js中定义的保持一致。
  3. RequiredScript:指定客户端需要的脚本,这样Atlas会以axd文件的形式将ValidateUserNameBehavior.js链接到页面上。

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

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

posted on 2006-06-08 16:20  Dflying Chen  阅读(...)  评论(...编辑  收藏