如何添加用户控件的属性

  1. //本文章说明如何添加用户控件的属性.
  2. //达到图片中的效果.

  3. //要编写用户控件需要加此声明
  4. using System;   
  5. using System.Web.UI;  
  7. //要有属性栏输入输出,就要加此声明.
  8. using System.ComponentModel;   
  9.   
  10. namespace CustomComponents   
  11. {   
  12. //DefaultPropertyAttribute：为组件指定一个默认的属性，
  13. //当用户在Form设计器上选择一个控件的时候，默认属性会在属性浏览器里被选中。     
  14.         [DefaultPropertyAttribute("CardholderNameText")]   
  15.     
  16. //还不知道是什么作用.
  17.         [ToolboxData(@"<{0}:CreditCardForm2  
  18.         PaymentMethodText='信用卡类型' CreditCardNoText='信用卡卡号'  
  19.         CardholderNameText='信用卡持有者姓名' SubmitButtonText = '提交'   
  20.         runat='server'></{0}:CreditCardForm2>")   
  21.         ]   
  22.     publicclass CreditCardForm2 : Control   
  23.         {   
  24.         privatestring paymentMethodText = "信用卡类型";   
  25.         privatestring creditCardNoText = "信用卡卡号";   
  26.         privatestring cardholderNameText = "信用卡持有者姓名";   
  27.         privatestring expirationDateText = "最后使用时间";   
  28.         privatestring submitButtonText = "提交";   
  29.   
  30. //BrowsableAttribute：描述是否一个属性或事件应该被显示在属性浏览器里。
  31.             [BrowsableAttribute(false)]   
  32. //DescriptionAttribute：当用户在属性浏览器里选择属性的时候，
  33. //description里指定的文本会显示在属性浏览器的下边，向用户显示属性的功能。
  34.             [DescriptionAttribute("获取和设置信用卡类型")]   
  35. //DefaultValueAttribute：为一个简单类型的属性设置一个默认值。
  36.             [DefaultValueAttribute("信用卡类型")]   
  37. //CategoryAttribute：描述一个属性或事件的类别，当使用类别的时候，
  38. //属性浏览器按类别将属性分组。
  39.             [CategoryAttribute("Appearance")]   
  42.         publicvirtualstring PaymentMethodText   
  43.             {   
  44.             get { returnthis.paymentMethodText; }   
  45.             set { this.paymentMethodText = value; }   
  46.             }   
  47.   
  48.             [BrowsableAttribute(true)]   
  49.             [DescriptionAttribute("获取或设置信用卡卡号")]   
  50.             [DefaultValueAttribute("信用卡卡号")]   
  51.             [CategoryAttribute("Appearance")]   
  52.         publicvirtualstring CreditCardNoText   
  53.             {   
  54.             get { returnthis.creditCardNoText; }   
  55.             set { this.creditCardNoText = value; }   
  56.             }   
  57.   
  58.             [BrowsableAttribute(true)]   
  59.             [DescriptionAttribute("获取或设置信用卡持有者姓名")]   
  60.             [DefaultValueAttribute("信用卡持有者姓名")]   
  61.             [CategoryAttribute("Appearance")]   
  62.         publicvirtualstring CardholderNameText   
  63.             {   
  64.             get { returnthis.cardholderNameText; }   
  65.             set { this.cardholderNameText = value; }   
  66.             }   
  67.   
  68.             [BrowsableAttribute(true)]   
  69.             [DescriptionAttribute("获取或设置最后使用时间")]   
  70.             [DefaultValueAttribute("最后使用时间")]   
  71.             [CategoryAttribute("Appearance")]   
  72.         publicvirtualstring ExpirationDateText   
  73.             {   
  74.             get { returnthis.expirationDateText; }   
  75.             set { this.expirationDateText = value; }   
  76.             }   
  77.   
  78.             [BrowsableAttribute(true)]   
  79.             [DescriptionAttribute("获取或设置按钮标签")]   
  80.             [DefaultValueAttribute("提交")]   
  81.             [CategoryAttribute("Appearance")]   
  82.         publicvirtualstring SubmitButtonText   
  83.             {   
  84.             get { returnthis.submitButtonText; }   
  85.             set { this.submitButtonText = value; }   
  86.             }   
  87.   
  88.         protectedoverridevoid Render(HtmlTextWriter writer)   
  89.             {   
  90.                 writer.Write("<table style='width:287px;height:124px;border-width:0;'>");   
  91.                 writer.Write("<tr>");   
  92.                 writer.Write("<td>" + PaymentMethodText + "</td>");   
  93.                 writer.Write("<td>");   
  94.                 writer.Write("<select name='PaymentMethod' id='PaymentMethod' style='width:100%;'>");   
  95.                 writer.Write("<option value='0'>Visa</option>");   
  96.                 writer.Write("<option value='1'>MasterCard</option>");   
  97.                 writer.Write("</select>");   
  98.                 writer.Write("</td>");   
  99.                 writer.Write("</tr>");   
  100.                 writer.Write("<tr>");   
  101.                 writer.Write("<td>" + CreditCardNoText + "</td>");   
  102.                 writer.Write("<td><input name='CreditCardNo' id='CreditCardNo' type='text' /></td>");   
  103.                 writer.Write("</tr>");   
  104.                 writer.Write("<tr>");   
  105.                 writer.Write("<td>" + CardholderNameText + "</td>");   
  106.                 writer.Write("<td><input name='CardholderName' id='CardholderName' type='text' /></td>");   
  107.                 writer.Write("</tr>");   
  108.                 writer.Write("<tr>");   
  109.                 writer.Write("<td>" + ExpirationDateText + "</td>");   
  110.                 writer.Write("<td>");   
  111.                 writer.Write("<select name='Month' id='Month'>");   
  112.             for (int day = 1; day < 13; day++)   
  113.                 {   
  114.                 if (day < 10)   
  115.                         writer.Write("<option value='" + day.ToString() + "'>" + "0" + day.ToString() + "</option>");   
  116.                 else  
  117.                         writer.Write("<option value='" + day.ToString() + "'>" + day.ToString() + "</option>");   
  118.                 }   
  119.                 writer.Write("</select>");   
  120.                 writer.Write(" ");   
  121.                 writer.Write("<select name='Year' id='Year'>");   
  122.             for (int year = 2005; year < 2015; year++)   
  123.                 {   
  124.                     writer.Write("<option value='" + year.ToString() + "'>" + year.ToString() + "</option>");   
  125.                 }   
  126.                 writer.Write("</select>");   
  127.                 writer.Write("</td>");   
  128.                 writer.Write("</tr>");   
  129.                 writer.Write("<tr>");   
  130.                 writer.Write("<td align='center' colspan='2'>");   
  131.                 writer.Write("<input type='submit' value='" + SubmitButtonText + "' />");   
  132.                 writer.Write("</td>");   
  133.                 writer.Write("</tr>");   
  134.                 writer.Write("</table>");   
  135.   
  136.             base.Render(writer);   
  137.             }   
  138.         }   
  139. }   
  140.   
  141. //在这个属性之上有两个Attribute，这两个attribute描述了控件在设计时所表现出来的特征。我们来看看在控件设计中有哪些主要用到的设计时Attribute。    
  142. //BrowsableAttribute：描述是否一个属性或事件应该被显示在属性浏览器里。   
  143. //CategoryAttribute：描述一个属性或事件的类别，当使用类别的时候，属性浏览器按类别将属性分组。   
  144. //DescriptionAttribute：当用户在属性浏览器里选择属性的时候，description里指定的文本会显示在属性浏览器的下边，向用户显示属性的功能。   
  145. //BindableAttribute：描述是否一个属性倾向于被绑定。   
  146. //DefaultPropertyAttribute：为组件指定一个默认的属性，当用户在Form设计器上选择一个控件的时候，默认属性会在属性浏览器里被选中。      
  147. //DefaultValueAttribute：为一个简单类型的属性设置一个默认值。   
  148. //EditorAttribute：为属性指定一个特殊的编辑器。   
  149. //LocalizableAttribute：指示一个属性是否能被本地化，任何有这个Attribute的属性将会被持久化到资源文件里。      
  150. //DesignerSerializationVisibilityAttribute：指示一个属性是否或者如何持久化到代码里。   
  151. //TypeConverterAttribute：为属性指定一个类型转换器，类型转换器能将属性的值转化成其它的数据类型。   
  152. //DefaultEventAttribute：为组件指定一个默认的事件，当用户在form设计其中选择一个控件的时候，在属性浏览器中这个事件被选中。   
  153. //这些设计时的Attribute时很重要的，如果使用的好，将会对用户的使用带来很大的便利。


转自：http://hi.baidu.com/05944/blog/item/24db324e023770cbd1c86a9f.html

posted @ 2010-01-15 15:19  哈仔  阅读(2459)  评论(0)  编辑  收藏  举报