ASP.NET 2.0服務(wù)器控件開(kāi)發(fā)之復(fù)雜屬性

在上一篇文章中，曾經(jīng)提及“復(fù)雜屬性”的概念。復(fù)雜屬性的最大特征是屬性的類型是本身具有屬性（稱為子屬性）的類。通常情況下，復(fù)雜屬性表現(xiàn)為3種形式：連字符形式屬性、內(nèi)部嵌套形式屬性和內(nèi)部嵌套形式默認(rèn)屬性。本文將介紹以上3種形式復(fù)雜屬性的具體實(shí)現(xiàn)方法。

　　1. 實(shí)現(xiàn)連字符形式復(fù)雜屬性

　　連字符形式屬性是比較常見(jiàn)的復(fù)雜屬性。我們常用的Font屬性就是一個(gè)復(fù)雜屬性，其包括多個(gè)子屬性，如Bold、Name等。這種類型屬性具有兩種語(yǔ)法格式：一種是利用連字符語(yǔ)法，在控件的開(kāi)始標(biāo)記中保存子屬性，例如，F(xiàn)ont-Bold，F(xiàn)ont-Name。另外一種格式是在控件的標(biāo)記中保存子屬性，例如，＜font Bold="true" /＞。后者比前者的可讀性強(qiáng)。

　　實(shí)現(xiàn)連字符形式的復(fù)雜屬性，必須對(duì)該復(fù)雜屬性及其子屬性實(shí)現(xiàn)設(shè)置指定的設(shè)計(jì)時(shí)元數(shù)據(jù)。下面首先列舉了復(fù)雜屬性實(shí)現(xiàn)過(guò)程中的相關(guān)元數(shù)據(jù)設(shè)置示例。請(qǐng)閱讀下面的源代碼。

public class CustomerControl:WebControl{
　[ DesignerSerializationVisibility( DesignerSerializationVisibility.Content), NotifyParentProperty(true) ]
　public SizeInfo Size { ...... }
}
　　如上代碼所示，Size是一個(gè)復(fù)雜屬性，其屬性類型為SizeInfo（自定義類）。在Size屬性實(shí)現(xiàn)前設(shè)置了兩個(gè)設(shè)計(jì)時(shí)元數(shù)據(jù)：DesignerSerializationVisibility和NotifyParentProperty。DesignerSerializationVisibility用于指定在設(shè)計(jì)時(shí)序列化組件上的屬性時(shí)，所使用的持久性類型。其值設(shè)置為DesignerSerializationVisibility.Content枚舉值，用于指定序列化程序應(yīng)該序列化屬性的內(nèi)容即子屬性，而不是Size屬性本身，因?yàn)樾蛄谢疭ize沒(méi)有任何意義。另外，還包括一個(gè)NotifyParentProperty(true)設(shè)置，它的作用是使得屬性瀏覽器中對(duì)子屬性的修改通知一直上傳到對(duì)象模型，并在被修改了子屬性的控件中產(chǎn)生修改通知。

　　在完成了復(fù)雜屬性的元數(shù)據(jù)設(shè)置后，開(kāi)發(fā)人員還必須對(duì)子屬性設(shè)置相關(guān)的設(shè)計(jì)時(shí)元數(shù)據(jù)。例如，Size包括兩個(gè)子屬性Height和Width，那么它們的實(shí)現(xiàn)代碼應(yīng)如下所示。

[TypeConverter(typeof(ExpandableObjectConverter))]public class SizeInfo{
　[ NotifyParentProperty(true) ]
　public UInt32 Height {......}
　[ NotifyParentProperty(true) ]
　public UInt32 Width {......}
}
　　如上代碼所示，子屬性Height和Width分別被設(shè)置了元數(shù)據(jù)NotifyParentProperty(true)。這樣，當(dāng)子屬性發(fā)生修改時(shí)，.NET框架將自動(dòng)產(chǎn)生修改通知，并且通知到父屬性Size。另外，還有一個(gè)設(shè)計(jì)時(shí)特性TypeConverter(typeof(ExpandableObjectConverter))，它告訴屬性瀏覽器提供擴(kuò)展和折疊樣式，這樣控件開(kāi)發(fā)者可以在屬性瀏覽器中直接編輯子屬性。

　　以上介紹了聲明連字符形式屬性的方法。從中可以看出，在聲明連字符屬性過(guò)程中需要把握兩個(gè)要點(diǎn)：一是復(fù)雜屬性的設(shè)計(jì)時(shí)元數(shù)據(jù)設(shè)置；二是子屬性的設(shè)計(jì)時(shí)特性設(shè)置。

　　2. 實(shí)現(xiàn)內(nèi)部嵌套形式復(fù)雜屬性

　　通常情況下，開(kāi)發(fā)人員多實(shí)現(xiàn)連字符形式的復(fù)雜屬性。然而，對(duì)復(fù)雜屬性還可以實(shí)現(xiàn)內(nèi)部嵌套的形式。下面的代碼就是一個(gè)典型的內(nèi)部潛逃形式復(fù)雜屬性的應(yīng)用。

＜MyControl:CustomeControl id="demo1" runat="server"＞
＜HeaderStyle ForeColor="#FFFF00" BackColor="#99ff00"＞
＜/HeaderStyle＞
... ...
＜/MyControl: CustomeControl＞
　　如上代碼所示，自定義控件MyControl的屬性HeaderStyle是一個(gè)典型的內(nèi)部嵌套形式屬性。實(shí)現(xiàn)這種形式的屬性與實(shí)現(xiàn)連字符形式屬性有很大不同，需要分為兩種情況。

　　如果自定義服務(wù)器控件類繼承自Control類，那么必須在控件類之前設(shè)置元數(shù)據(jù)屬性ParseChildren和PersistChildren。示意性代碼如下所示。

[ParseChildren(true),PersistChildren(false)]
public class CustomeControl:Control{ ......}
　　如上代碼所示，在控件類前設(shè)置了兩個(gè)元數(shù)據(jù)屬性ParseChildren和PersistChildren。前者用于告知頁(yè)面分析器把控件標(biāo)記中的內(nèi)容解析為屬性還是子控件，該屬性值設(shè)置為true，則表示解析為屬性。后者用于告知設(shè)計(jì)器把控件標(biāo)記中的內(nèi)容保存為屬性還是子控件，該屬性值設(shè)置為false，表示保存為屬性。

　　如果自定義控件類繼承自WebControl類，那么就不需要以上的元數(shù)據(jù)屬性設(shè)置，因?yàn)椋琖ebControl類已經(jīng)應(yīng)用了這些元數(shù)據(jù)屬性了。

　　無(wú)論自定義控件類繼承自WebControl類還是Control類，為實(shí)現(xiàn)內(nèi)部嵌套形式復(fù)雜屬性，都必須在屬性實(shí)現(xiàn)中設(shè)置如下元數(shù)據(jù)屬性。

[ DesignerSerializationVisibility( DesignerSerializationVisibility.Content), NotifyParentProperty(true), PersistenceMode(PersistenceMode.InnerProperty)]
public TableItemStyle HeaderStyle{......}
　　由上面的代碼可以看到，必須在實(shí)現(xiàn)復(fù)雜屬性之前，應(yīng)用3個(gè)元數(shù)據(jù)屬性：DesignerSerializationVisibility、NotifyParentProperty和PersistenceMode。前兩個(gè)元數(shù)據(jù)屬性在前文中已經(jīng)說(shuō)明，第三個(gè)PersistenceMode用于指定如何將服務(wù)器控件屬性或事件保持到ASP.NET頁(yè)的元數(shù)據(jù)屬性，該特性的值設(shè)置為枚舉值：PersistenceMode.InnerProperty，這表示將所標(biāo)識(shí)屬性（HeaderStyle）保持為嵌套標(biāo)記。

　　以上介紹了內(nèi)部嵌套形式屬性聲明的方法。總結(jié)起來(lái)分為兩種情況：一是所開(kāi)發(fā)控件從Control派生，則需要設(shè)置五個(gè)設(shè)計(jì)時(shí)特性ParseChildrenAttribute(true)、PersistChildren(false)、DesignerSerializationVisibility、NotifyParentProperty和PersistenceMode。前兩個(gè)特性在控件類前設(shè)置，用于告訴編譯器將控件標(biāo)記內(nèi)的內(nèi)容為屬性，需要解析為屬性；后三個(gè)特性在屬性前指定，用于指示編譯器此屬性為內(nèi)部嵌套形式屬性，在應(yīng)用控件屬性時(shí)，必須采用嵌套形式。二是所開(kāi)發(fā)控件從WebControl派生，這種情況比較簡(jiǎn)單，只需設(shè)置上文中后3個(gè)設(shè)計(jì)時(shí)特性即可。

　　3. 實(shí)現(xiàn)內(nèi)部嵌套形式默認(rèn)復(fù)雜屬性

　　內(nèi)部嵌套形式默認(rèn)屬性與內(nèi)部嵌套形式屬性非常類似，它通常用于設(shè)置某個(gè)控件的集合屬性。例如，標(biāo)準(zhǔn)服務(wù)器控件中的DataList、DropDownList控件中的屬性均為內(nèi)部嵌套形式默認(rèn)屬性。

　　為了實(shí)現(xiàn)這種形式的屬性，主要需設(shè)置兩個(gè)元數(shù)據(jù)屬性：一是在控件類前設(shè)置ParseChildren(true, "DefaultPropertyName")，指定該控件中嵌套的標(biāo)記表示屬性，而非子控件，同時(shí)將嵌套屬性分析為該控件的集合屬性；二是在集合屬性前設(shè)置特性PersistenceMode(PersistenceMode.InnerDefaultProperty)，表示將該屬性定義為控件的默認(rèn)屬性。

　　4. 小結(jié)

　　本文介紹了創(chuàng)建復(fù)雜屬性的實(shí)現(xiàn)方法。這是實(shí)現(xiàn)自定義服務(wù)器控件過(guò)程中的重點(diǎn)和難點(diǎn)內(nèi)容。在隨后的一篇文章中，我們將通過(guò)示例來(lái)加深對(duì)復(fù)雜屬性實(shí)現(xiàn)方法的認(rèn)識(shí)。

聲明：本網(wǎng)頁(yè)內(nèi)容旨在傳播知識(shí)，若有侵權(quán)等問(wèn)題請(qǐng)及時(shí)與本網(wǎng)聯(lián)系，我們將在第一時(shí)間刪除處理。TEL:177 7030 7066 E-MAIL:11247931@qq.com