開發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基類，其中定義的是客戶端屬性值與伺服器端屬性值之間的映射關係。同時，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。