C#控件开发(三)
六、 扩展属性和字符串转换:TypeConverter和属性窗口
.NET属性窗口最重要的一个特性就是可以显示嵌套的属性,这样就提供了比属性类别更加细化和更有逻辑的分类。嵌套属性对于类目显示和排序显示都是适用的。这样可以让属性列表更加紧凑。比如我们用带有子属性X和Y的一个Location属性来代替Top和Left两个属性就更加合理。
不过,如何来决定一个属性可以展开呢?这些不是由属性窗口来决定,而是取决于属性自己的类型。在.NET framework中,每一种类型都是和一个TypeConverter联系在一起的。比如Boolean和string的TypeConverter就不会允许展开。因为让boolean类型含有子属性是没有意义的。
在.NET framework中,TypeConverter实际上是执行了不少的方法,在属性窗口中就更多了。正像他的名字所说明的那样,TypeConverter提供了一种动态的从一种类型改变到另一种类型的标准方式。事实上,属性窗口只和string打交道。所以他就依赖于TypeConverter来进行类型之间的转换(主要是和string类型的转换)。TypeConverter同样是可以提供扩展性能以及复杂类型来和属性窗口交互。
比如,看下面这个Person类:
[TypeConverter(typeof(PersonConverter))]
public class Person
{
private string firstName = "";
private string lastName = "";
private intage = 0;
public int Age
{
get
{
return age;
}
set
{
age = value;
}
}
public string FirstName
{
get
{
return firstName;
}
set
{
this.firstName = value;
}
}
public string LastName
{
get
{
return lastName;
}
set
{
this.lastName = value;
}
}
}
我们注意到Person类被指定了TypeConverterAttribute特性,TypeConverterAttribute特性还指定了这个类的类型转换器(PersonConverter)。如果没有指定TypeConverterAttribute特性,默认使用TypeConverter类,对于一些简单数据类型,比如Font Point等,TypeConverter可以很好地工作,但如果数据类型比较复杂,那么它对类型是转换可能就不是我们希望的那样,因此,我们有必要从TypeConverter派生自己的类型转换器,在这里就是PersonConverter,本例中,我们首先重载了GetPropertiesSupported和GetProperties方法来决定属性是否可以展开。
internal class PersonConverter : TypeConverter
{
public override PropertyDescriptorCollection
GetProperties(ITypeDescriptorContext context,
object value,
Attribute[] filter)
{
return TypeDescriptor.GetProperties(value, filter);
}
public override bool GetPropertiesSupported(
ITypeDescriptorContext context)
{
return true;
}
}
在通常情况下,直接使用TpyeConverter进行转换已经足够了。简单的扩展就是从TypeConverter直接派生你所要的类型转换器,更复杂的扩展就需要从ExpandableObjectConverter派生类型转换器了。现在我们修改PersonConverter来转换一个Person类并且显示一个字符串。
internal class PersonConverter : ExpandableObjectConverter
{
public override bool CanConvertFrom(
ITypeDescriptorContext context, Type t)
{
if (t == typeof(string))
{
return true;
}
return base.CanConvertFrom(context, t);
}
public override object ConvertFrom(
ITypeDescriptorContext context,
CultureInfo info,
object value)
{
if (value is string)
{
try
{
string s = (string) value;
// parse the format "Last, First (Age)"
//
int comma = s.IndexOf(',');
if (comma != -1)
{
// now that we have the comma, get
// the last name.
string last = s.Substring(0, comma);
int paren = s.LastIndexOf('(');
if (paren != -1 && s.LastIndexOf(')') == s.Length - 1)
{
// pick up the first name
string first = s.Substring(comma + 1, paren - comma - 1);
// get the age
int age = Int32.Parse(
s.Substring(paren + 1,
s.Length - paren - 2));
Person p = new Person();
p.Age = age;
p.LastName = last.Trim();
p.FirstName = first.Trim();
return p;
}
}
}
catch {}
// if we got this far, complain that we
// couldn't parse the string
//
throw new ArgumentException(
"Can not convert '" + (string)value +
"' to type Person");
}
return base.ConvertFrom(context, info, value);
}
public override object ConvertTo(
ITypeDescriptorContext context,
CultureInfo culture,
object value,
Type destType)
{
if (destType == typeof(string) && value is Person)
{
Person p = (Person)value;
// simply build the string as "Last, First (Age)"
return p.LastName + ", " +
p.FirstName + " (" + p.Age.ToString() + ")";
}
return base.ConvertTo(context, culture, value, destType);
}
}
现在看看我们的Person属性在指定了PersonConverter类型转换器之后,既可以展开,又可以通过两种方式来操作了:直接修改和使用子属性。
要使用上面的代码,我们就生成一个UserControl并且写下如下的代码:
private Person p = new Person();
public Person Person
{
get
{
return p;
}
set
{
this.p = value;
}
}
.NET属性窗口最重要的一个特性就是可以显示嵌套的属性,这样就提供了比属性类别更加细化和更有逻辑的分类。嵌套属性对于类目显示和排序显示都是适用的。这样可以让属性列表更加紧凑。比如我们用带有子属性X和Y的一个Location属性来代替Top和Left两个属性就更加合理。
不过,如何来决定一个属性可以展开呢?这些不是由属性窗口来决定,而是取决于属性自己的类型。在.NET framework中,每一种类型都是和一个TypeConverter联系在一起的。比如Boolean和string的TypeConverter就不会允许展开。因为让boolean类型含有子属性是没有意义的。
在.NET framework中,TypeConverter实际上是执行了不少的方法,在属性窗口中就更多了。正像他的名字所说明的那样,TypeConverter提供了一种动态的从一种类型改变到另一种类型的标准方式。事实上,属性窗口只和string打交道。所以他就依赖于TypeConverter来进行类型之间的转换(主要是和string类型的转换)。TypeConverter同样是可以提供扩展性能以及复杂类型来和属性窗口交互。
比如,看下面这个Person类:
[TypeConverter(typeof(PersonConverter))]
public class Person
{
private string firstName = "";
private string lastName = "";
private intage = 0;
public int Age
{
get
{
return age;
}
set
{
age = value;
}
}
public string FirstName
{
get
{
return firstName;
}
set
{
this.firstName = value;
}
}
public string LastName
{
get
{
return lastName;
}
set
{
this.lastName = value;
}
}
}
我们注意到Person类被指定了TypeConverterAttribute特性,TypeConverterAttribute特性还指定了这个类的类型转换器(PersonConverter)。如果没有指定TypeConverterAttribute特性,默认使用TypeConverter类,对于一些简单数据类型,比如Font Point等,TypeConverter可以很好地工作,但如果数据类型比较复杂,那么它对类型是转换可能就不是我们希望的那样,因此,我们有必要从TypeConverter派生自己的类型转换器,在这里就是PersonConverter,本例中,我们首先重载了GetPropertiesSupported和GetProperties方法来决定属性是否可以展开。
internal class PersonConverter : TypeConverter
{
public override PropertyDescriptorCollection
GetProperties(ITypeDescriptorContext context,
object value,
Attribute[] filter)
{
return TypeDescriptor.GetProperties(value, filter);
}
public override bool GetPropertiesSupported(
ITypeDescriptorContext context)
{
return true;
}
}
在通常情况下,直接使用TpyeConverter进行转换已经足够了。简单的扩展就是从TypeConverter直接派生你所要的类型转换器,更复杂的扩展就需要从ExpandableObjectConverter派生类型转换器了。现在我们修改PersonConverter来转换一个Person类并且显示一个字符串。
internal class PersonConverter : ExpandableObjectConverter
{
public override bool CanConvertFrom(
ITypeDescriptorContext context, Type t)
{
if (t == typeof(string))
{
return true;
}
return base.CanConvertFrom(context, t);
}
public override object ConvertFrom(
ITypeDescriptorContext context,
CultureInfo info,
object value)
{
if (value is string)
{
try
{
string s = (string) value;
// parse the format "Last, First (Age)"
//
int comma = s.IndexOf(',');
if (comma != -1)
{
// now that we have the comma, get
// the last name.
string last = s.Substring(0, comma);
int paren = s.LastIndexOf('(');
if (paren != -1 && s.LastIndexOf(')') == s.Length - 1)
{
// pick up the first name
string first = s.Substring(comma + 1, paren - comma - 1);
// get the age
int age = Int32.Parse(
s.Substring(paren + 1,
s.Length - paren - 2));
Person p = new Person();
p.Age = age;
p.LastName = last.Trim();
p.FirstName = first.Trim();
return p;
}
}
}
catch {}
// if we got this far, complain that we
// couldn't parse the string
//
throw new ArgumentException(
"Can not convert '" + (string)value +
"' to type Person");
}
return base.ConvertFrom(context, info, value);
}
public override object ConvertTo(
ITypeDescriptorContext context,
CultureInfo culture,
object value,
Type destType)
{
if (destType == typeof(string) && value is Person)
{
Person p = (Person)value;
// simply build the string as "Last, First (Age)"
return p.LastName + ", " +
p.FirstName + " (" + p.Age.ToString() + ")";
}
return base.ConvertTo(context, culture, value, destType);
}
}
现在看看我们的Person属性在指定了PersonConverter类型转换器之后,既可以展开,又可以通过两种方式来操作了:直接修改和使用子属性。
要使用上面的代码,我们就生成一个UserControl并且写下如下的代码:
private Person p = new Person();
public Person Person
{
get
{
return p;
}
set
{
this.p = value;
}
}