開發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。