属性(property)作为c#语言中一个重要的组成部分,尤其是在我们自己编写组件的时候显得更加重要。我相信大家一定对其有一定的了解。但是大家是否注意到了一个非常关键得细节问题呢?那就是在大家使用任何得组件的时候都需要通过属性浏览器给每一属性赋值,而且更加友好的是对于每种不同类型属性都会自己的形式。比如:数字类型、字符串类型是默认简单的输入的形式,而如Font、Color类型的属性则可以对话框或下拉列表框的形式。不知道大家是否知道这些是如何编写的?其实这些功能都是通过属性(Property)的(Attribute)来实现的,下面我就这个问题和大家一起学习,不过在阅读本文之前要求大家对属性(Property)有一定的了解,好下面我们言归正传。
实际上Property和Attribute翻译成中文都是属性的意思,但是在英文中却有着微小的差别。因为在中文中不好区别Property和Attribute,所以我暂时的把这两个单词翻译成属性(Property)和性质(Attribute),如果有什么不对的地方请大家指出。
在C#中不仅仅属性有自己的性质,类、方法、事件等都有自己的性质,由于本人知识限,所以只能给大家介绍一下属性的性质了请大家原谅。
现在大家知道了性质,但是在C#中究竟什么是性质呢?下面我用一个例子来告诉大家,请看下面的一个WebService的例子:
[WebMethod]
public string HelloWorld()
{
return "Hello World by zhx";
}
这是一个WebService中一个对外发布方法的例子,其中[WebMethod]就是这个方法的Attribute。在WebService中如果方法不加上这个性质就不能够对外发布,我在第一次用C#写WebService时就没用使用这个性质导致我还以为是我程序的错误了呢。
下面给大家看一个属性的性质的例子:
private int _value;
[DefaultValue(1)]
[Description("文本框的值")]
public int Value
{
get
{
return this._value
}
set
{
this._value=value;
}
}
大家把这两个性质[DefaultValue(1)]、[Description("文本框的值")]用到自己的性质以后,会发现什么?大家可以自己试验一下。属性的性质主要对.Net环境中的属性编辑器起到UI的作用,所以大家在编写完成代码的时候先要编译一下,然后再在窗体中引用呢自己的组件选定这个属性才能起到作用。好,下面我就向大家一一的介绍我知道的性质。
先从简单的给大家介绍:
1、 CategoryAttribute 大家从这个名字就可以看出来他的作用了,他的作用是把所定义的属性按照一定的类型分类,就好像大家在系统中看到的“外观”等的分类一样。
2、 DescriptionAttribute 不知道大家是否还记得在系统中当选中一个属性之后,在属性浏览器中的下方就会出现该属性的文字描述。这个性质就是起到了这样的功能。
3、 DefaultValueAttribute 顾名思义这个性质当然是设置默认值的功能了,当用户制定了改默认值后,属性浏览器就会以加粗的字体显示。
4、 ReadOnlyAttribute 这个性质也不难看出他是设置属性的只读性,这里的只读性可不是属性真正的只读性,在这里只是指出在属性浏览器中是否可以改写的性质。
5、 browerAbleAttribute 这个性质功能是指出在属性浏览器中是否可以浏览该属性。有一些属性是不希望在设计期间或者用属性浏览器改写的,就可以制定改性质。
这几个性质不仅可以单独使用,而且可以一起使用,下面是使用这几个性质的一个例子:
private string _appVer="1.0";
[CategoryAttribute("自定义编辑器"),
DefaultValueAttribute("1.0"),
DescriptionAttribute("版本信息"),
ReadOnlyAttribute(true),
browerAbleAttribute(true)]
public string AppVer
{
get {return this._appVer;}
set {this._appVer=value;}
}
在编译、选定改属性之后可以看到如下的画面。其中以红色椭圆型标出的就是DescriptionAttribute性质所起到的作用,而其他性质得到的UI作用是在红色矩形框中所展现的内容。
不知道大家是否发现在我的属性AppVer和你的有一点不一样?大家仔细看看,对了就是在我的属性后面还多出了一个浏览按钮,而且单击他会弹出一个对话框,显示版本信息,大家一定想知道这个功能是作用做出来的,大家先不要着急后面我在向大家介绍。
不知道大家是否注意到了,我们在使用Size、Font、Color等类型作为属性的时候属性浏览器会以怎样的形式来改变我们属性的值呢?下面的三个画面。
大家仔细的研究一下就可看出这三个属性可以分为基本的四个类型,Enum是下拉列表框的形式、Size是展开的形式、Font是弹出窗体的形式、Color是下拉UI的形式。但是对于性质的角度却分为两种类型,前两类Enum、Size需要的性质是属性转换器(TypeConverter),而后两种形式是需要编辑器(UITypeEditor)的。下面我就分别介绍这两种性质。
1、 下拉列表框的形式:
要使用下拉列表框的形式的属性我们首先要定义一个属性,在这个例子中我定义了一个字符串类型的属性 FileName。
private string _fileName;
public string FileName
{
get { return this._fileName;}
set { this._fileName=value; }
}
定义完属性之后,我们还要自己一个属性转换器。那么什么是属性转换器呢?其实在属性浏览器中只能够识别字符串类型,所以我们要通过属性转换器把我们的属性转换成字符串,还要在属性浏览器改变这个字符串之后在把这个字符串转换成我们自己的属性。大家听起来是不是有一些胡涂了?没关系下面我们做一个属性转换器大家就知道了。
因为在本例中用的属性是字符串类型的所以我们要从System.ComponentModel.StringConverter继承一个新的字符串形式的属性转换器。下面就是这段代码和代码中的注释,相信大家一定能够看懂的:
/// <summary>
/// 扩展字符串的转换器(实现下拉列表框的样式)
/// </summary>
public class FileNameConverter:System.ComponentModel.StringConverter
{
/// <summary>
/// 根据返回值确定是否支持下拉框的形式
/// </summary>
/// <returns>
/// true: 下来框的形式
/// false: 普通文本编辑的形式
/// </returns>
public override bool GetStandardValuesSupported(System.ComponentModel.ITypeDescriptorContext context)
{
return true;
}
/// <summary>
/// 下拉框中具体的内容
/// </summary>
public override System.ComponentModel.TypeConverter.StandardValuesCollection GetStandardValues(System.ComponentModel.ITypeDescriptorContext context)
{
return new StandardValuesCollection(new string[]{"File1.bat","File2.exe","File3.dll"});
}
/// <summary>
/// 根据返回值确定是否是不可编辑的文本框
/// </summary>
/// <returns>
/// true: 文本框不可以编辑
/// flase: 文本框可以编辑
/// </returns>
public override bool GetStandardValuesExclusive(System.ComponentModel.ITypeDescriptorContext context)
{
return true;
}
好了,属性转换器写完了,最后别忘了把这个属性转换器指定到我们刚才所写的属性上哦,代码如下:
[CategoryAttribute("自定义的复杂类型设置(包括自定义类型转换器)"),
TypeConverterattribute(typeof(PropertyGridApp.FileNameConverter)),
ReadOnlyAttribute(false)]
public string FileName
{
get { return this._fileName;}
set { this._fileName=value; }
}
编译之后的程序画面如下
展开的形式多用于一个属性为我们自定义类的类型,比如我们定义了一个类,该类中的一个属性是另一个我们定义的类。在这种情况下属性浏览器默认是没有办法来进行类型转换的,所以显示为不可编辑的内容。如果我们要以展开的形式编辑这个属性就需要我们向上面一样来重写属性转换器。
我们首先定义一个自己的类来作为以后的属性类型。具体代码如下:
public class ExpandProperty
{
private int _intList=0;
public int IntList
{
get { return this._intList;}
set { this._intList=value; }
}
private string _strList="Null";
public string StrList
{
get { return this._strList;}
set { this._strList= value;}
}
}
然后我们在自己的另一个类中声明一个这个类型的属性,在这里如果我们不加任何的性质限制,属性浏览器是不能转换改属性的。具体实现该属性的代码如下:
private ExpandProperty _dropList;
[CategoryAttribute("自定义的复杂类型设置(包括自定义类型转换器)"),
TypeConverterattribute(typeof(PropertyGridApp.ExpandConverter)),
ReadOnlyAttribute(false)]
public ExpandProperty DropList
{
get { return this._dropList;}
set { this._dropList= value;}
}
为了让属性浏览器能够编辑该属性,也就是说能够把该属性转换成字符串,而且能够从字符串转换成该类的一个实例需要我们写如下的代码:
/// <summary>
/// 可以展开的类型转换器
/// ExpandProperty
/// </summary>
public class ExpandConverter:System.ComponentModel.ExpandableObjectConverter
{
public ExpandConverter()
{
}
/// <summary>
/// 覆盖此方法已确定属性是否可以转换
/// </summary>
public override bool CanConvertTo(System.ComponentModel.ITypeDescriptorContext context,System.Type destinationType)
{
if (destinationType==typeof(PropertyGridApp.ExpandProperty))
return true;
return base.CanConvertTo(context,destinationType);
}
/// <summary>
/// 覆盖此方法并确保destinationType参数是一个String,然后格式化所显示的内容
/// </summary>
public override object ConvertTo(System.ComponentModel.ITypeDescriptorContext context,System.Globalization.CultureInfo culture,object value,System.Type destinationType)
{
if (destinationType == typeof (System.String) && value is PropertyGridApp.ExpandProperty)
{
PropertyGridApp.ExpandProperty source=(PropertyGridApp.ExpandProperty)value;
return source.IntList+","+source.StrList;
}
return base.ConvertTo(context,culture,value,destinationType);
}
/// <summary>
/// 覆盖此方法已确定输入的字符串是可以被转化
/// </summary>
public override bool CanConvertFrom(System.ComponentModel.ITypeDescriptorContext context,System.Type sourceType)
{
if (sourceType==typeof(string))
return true;
return base.CanConvertFrom(context,sourceType);
}
/// <summary>
/// 覆盖此方法根据 ConvertTo() 方法的转换格式来把所输入的字符串转换成类,并返回该类
/// </summary>
public override object ConvertFrom(System.ComponentModel.ITypeDescriptorContext context,object value)
{
if (value is string)
{
string s=(string)value;
int comma=s.IndexOf(",");
if (comma!=-1)
{
try
{
string intList=s.Substring(0,comma);
string strList=s.Substring(comma+1,s.Length-comma-1);
PropertyGridApp.ExpandProperty Ep=new Expandproperty();
Ep.IntList=int.Parse(intList);
Ep.StrList=strList;
return Ep;
}
catch
{
return base.ConvertFrom(context,value);
}
}
}
return base.ConvertFrom(context,value);
}
}
编译之后的画面如下:
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 [email protected] 举报,一经查实,本站将立刻删除。