作者: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的定義前面加上了三個屬性:
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<ValidateUserNamePropertIEs, Control>
{
}
其中我們的ValidateUserNameExtender繼承於ExtenderControlBase<ValidateUserNamePropertIEs, Control>基類,得到一些共有的操作。並且在類上應用了三個屬性:
Designer:指定這個Extender的設計器(用於提供設計期支持)的類名。
ClIEntScriptResource:指定生成客戶端Atlas XML腳本所需要的信息。這裡的Dflying和ValidateUserNameBehavior都要和前面的ValidateUserNameBehavior.JS中定義的保持一致。
RequiredScript:指定客戶端需要的腳本,這樣Atlas會以axd文件的形式將ValidateUserNameBehavior.JS鏈接到頁面上。
最後是ValidateUserNameDesigner.cs文件,在這裡您可以添加設計期的支持程序。讓您的控件在Visual Studio中隨著設定的屬性值不同,顯示樣式也不同。這裡為了簡化,我就不添加設計期支持了。
值此為止,我們的Extender就寫好了,來一次Release Build以後生成的DLL就可以直接拿來使用了。在下一篇文章中,我將演示在實際程序中應用這個Extender。