【Winform窗体控件开发】之五 实现类型转换器TypeConverterAttribute

于 2015-10-11 22:26:35 发布
阅读量3.1k 收藏 4
点赞数
分类专栏： C#

转自:http://www.cnblogs.com/bobbychencj/archive/2010/12/08/1900252.html


        这次我们讲一下关于TypeConverterAttribute属性的使用。

使用场景

　　前几将我们了解了如何定义窗体控件的公共属性并在设计时指定属性的值，但是我们使用的都是简单的类型（如：Int32），如果我们的控件需要绑定一个我们自定义的类，并在设计时中指定该类的值我们就需要用到TypeConverterAttribute这个属性了。

实现方法

　　我们知道，在设计时中我们为窗体控件指定一个值的时候都是以String型变量来显示出来的（例如：我们在第三讲时，为窗体控件属性Age赋值时，虽然我们定义的是一个Int32型的变量，但是我们可以在Designer的Attribute中为Age输入一个String类型的值）。其实，这是因为系统已经为我们实现了一个由 Int32<——>String类型的转换器（Int32Converter）。

　　一般情况下，.Net Framework的FCL（Framework Class Library）中已经为内建类型提供了基本的转换器（举个例子：Int32类型对应的转换器是System.ComponentModel.Int32Converter，Enum对应是System.ComponentModel.EnumConverter）。

　　若是自定义类型需要实现设计时支持时，我们需要自定义实现类型转换器——实现自定义转换器需要继承自TypeConverter并override相应方法（后面的代码会具体实现）。

实例一【在窗体控件中实现enum预定义列表】

　　我们需要在一个控件上实现一个枚举的公共属性，并在设计时中能够使用下拉列表指定枚举的值。

自定义控件代码：

/*
实现在属性浏览器中提供标准值下拉列表的简单类型转换器
 
    1.定义一个从 TypeConverter 派生的类。

    2.重写 GetStandardValuesSupported 方法并返回 true。

    3.重写 GetStandardValues 方法并返回包含属性类型标准值的 TypeConverter.StandardValuesCollection。属性的标准值必须与属性自身的类型一致。

    4.重写 CanConvertFrom 方法并为类型字符串的 sourceType 参数值返回 true。

    5.重写 ConvertFrom 方法并基于 value 参数返回相应的属性值。

    6.将指示类型转换器类型的 TypeConverterAttribute 应用于要为其提供一组标准值的类型。
 */

using System.ComponentModel;
using System.Drawing;
using System.Windows.Forms;

namespace WinFormControlLibrary
{
    public partial class FourthControl自定义控件属性实现类型转换器之标准值下拉列表的类型转换器一 : Control
    {
        private MoneyType _moneyType;

        [Browsable(true)]
        public MoneyType MoneyType
        {
            get { return _moneyType; }
            set { _moneyType = value; }
        }

        public FourthControl自定义控件属性实现类型转换器之标准值下拉列表的类型转换器一()
        {
            InitializeComponent();
        }

        protected override void OnPaint(PaintEventArgs pe)
        {
            base.OnPaint(pe);

            #region 重绘控件
           
            Graphics g = pe.Graphics;

            #region 边框
            //
            // 设定大小区域
            //
            Size size = new Size(Size.Width - 1, Size.Height - 1);
            //
            // 设定Control 的大小
            //
            Rectangle rectagle = new Rectangle(Point.Empty, size);

            // 绘制控件边框
            g.DrawRectangle(Pens.Black, rectagle);
            #endregion 

            #region 文本内容
            g.DrawString(
                "自定义控件属性实现类型转换器之标准值下拉列表的类型转换器一", 
                Font, 
                Brushes.Black, 
                new PointF(1, 1)
                );
            #endregion

            #endregion
        }
    }

    #region Int32、String、枚举类型和其他类型具有默认的类型转换器。
    /// <summary>
    /// 因此，不用为基本类型实现TypeConverter转换器
    /// </summary>

    [TypeConverter(typeof(EnumConverter))] // 为对象指出使用转换器
    public enum MoneyType
    {
        人民币,
        美元,
        日元,
        法郎,
        英镑
    }

    #endregion
}

效果：

image

仔细观察代码你会发现，实现这个效果我们并没有增加新的额外代码（只是在MoneyType对象上增加了[TypeConverter(typeof(EnumConverter))]属性），这就是我们上面说的enum类型使用了.Net Framework 自己定义的转换器EnumConverter

实例二【实现自定义类型的预定义标准值列表】
/*
实现在属性浏览器中提供标准值下拉列表的简单类型转换器
    1.定义一个从 TypeConverter 派生的类。

    2.重写 GetStandardValuesSupported 方法并返回 true。

    3.重写 GetStandardValues 方法并返回包含属性类型标准值的 TypeConverter..::.StandardValuesCollection。属性的标准值必须与属性自身的类型一致。

    4.重写 CanConvertFrom 方法并为类型字符串的 sourceType 参数值返回 true。

    5.重写 ConvertFrom 方法并基于 value 参数返回相应的属性值。

    6.将指示类型转换器类型的 TypeConverterAttribute 应用于要为其提供一组标准值的类型。
 */
using System;
using System.ComponentModel;
using System.Drawing;
using System.Windows.Forms;
using System.Collections;
using System.Globalization;

namespace WinFormControlLibrary
{
    public partial class FourthControl自定义控件属性实现类型转换器之标准值下拉列表的类型转换器二 : Control
    {
        private int _friendsNum = 0;
        
        [TypeConverter(typeof(StandardValuesIntConverter))]
        public int FriendsNum
        {
            get
            {
                return this._friendsNum;
            }
            set
            {
                if (value.GetType() == typeof(int))
                    this._friendsNum = value;
            }
        }

        public FourthControl自定义控件属性实现类型转换器之标准值下拉列表的类型转换器二()
        {
            InitializeComponent();
        }

        protected override void OnPaint(PaintEventArgs pe)
        {
            base.OnPaint(pe);

            #region 重绘控件

            Graphics g = pe.Graphics;

            #region 边框
            //
            // 设定大小区域
            //
            Size size = new Size(Size.Width - 1, Size.Height - 1);
            //
            // 设定Control 的大小
            //
            Rectangle rectagle = new Rectangle(Point.Empty, size);

            // 绘制控件边框
            g.DrawRectangle(Pens.Black, rectagle);
            #endregion

            #region 文本内容
            g.DrawString(
                "自定义控件属性实现类型转换器之标准值下拉列表的类型转换器二",
                Font,
                Brushes.Black,
                new PointF(1, 1)
                );
            #endregion

            #endregion
        }
    }

    public class StandardValuesIntConverter : TypeConverter
    {
        private ArrayList arrValues;

        public StandardValuesIntConverter()
        {
            // Initializes the standard values list with defaults.
            arrValues = new ArrayList(new int[] { 1, 2, 3, 4, 5 });
        }

        // 是否支持标准值
        public override bool GetStandardValuesSupported(ITypeDescriptorContext context)
        {
            return true;
        }

        // 获取标准值集合
        public override TypeConverter.StandardValuesCollection GetStandardValues(ITypeDescriptorContext context)
        {
            StandardValuesCollection svc = new StandardValuesCollection(arrValues);
            return svc;
        }

        // 是否可以转换
        public override bool CanConvertFrom(ITypeDescriptorContext context, Type sourceType)
        {
            if (sourceType == typeof(string))
            {
                return true;
            }
            else
            {
                return base.CanConvertFrom(context, sourceType);
            }
        }

        public override object ConvertFrom(ITypeDescriptorContext context, System.Globalization.CultureInfo culture, object value)
        {
            if (value.GetType() == typeof(string))
            {
                // 转换到整型
                int newVal = int.Parse((string)value);

                if (!arrValues.Contains(newVal))
                {
                    arrValues.Add(newVal);
                    arrValues.Sort();
                }
                return newVal;
            }
            else
            {
                return base.ConvertFrom(context, culture, value);
            }
        }
    }
}

image

与enum类型不同，在这个窗体控件中我们使用了ArrayList对象保存我们预定义好的值，但是系统没有提供我们ArrayList对应的转换器，因此我们实现了一个自定义对象类型转换器StandardValuesIntConverter用来在设计时和代码之间进行对应。

注意：

　　在实例一和实例二我们声明的类型转化器位置不一样，实例一中是在自定义类上声明的，实例二中是在窗体控件的属性（自定义类）上声明的，但是效果一样。

【实例三】实例二中已经讲到如何对自定义类型的对象实现类型转换器，接下来我们再看一个实例，该实例与实例二比较相似，但是我们定义了一个Money的自定义类型用于窗体控件的属性，我们希望在设计时的ccMoney属性中输入一个特定格式的字符串（例如：123,456）来定义Money实例的值，123对应Min属性，456对应Max属性。

具体操作如下

money类型定义如下：

/// <summary>
/// 自定义对象
/// </summary>
public class Money
{
    private Int32 _min;
    private Int32 _max;

    [Browsable(true)]
    public Int32 Min
    {
        get { return _min; }
        set { _min = value; }
    }

    [Browsable(true)]
    public Int32 Max
    {
        get { return _max; }
        set { _max = value; }
    }

    public Money()
    {
    }

    public Money(Int32 min, Int32 max)
    {
        _min = min;
        _max = max;
    }
}

该对象类中有两个属性，我们需要在设计时中能够对窗体控件中的这两个属性进行设置。

实现方法如下

窗体控件代码：

using System;
using System.ComponentModel;
using System.Drawing;
using System.Windows.Forms;
using System.ComponentModel.Design.Serialization;
using System.Reflection;

namespace WinFormControlLibrary
{
    public partial class FourthControl自定义控件属性实现类型转换器之自定义类型 : Control
    {
        private String _ccMoney;

        [Browsable(true)]
        public String ccMoney
        {
            get 
            {
                return _ccMoney;
            }
            set
            {
                _ccMoney = value;
            }
        }

        public FourthControl自定义控件属性实现类型转换器之自定义类型()
        {
            InitializeComponent();
        }

        protected override void OnPaint(PaintEventArgs pe)
        {
            base.OnPaint(pe);

            #region 重绘控件

            Graphics g = pe.Graphics;

            #region 边框
            //
            // 设定大小区域
            //
            Size size = new Size(Size.Width - 1, Size.Height - 1);
            //
            // 设定Control 的大小
            //
            Rectangle rectagle = new Rectangle(Point.Empty, size);

            // 绘制控件边框
            g.DrawRectangle(Pens.Black, rectagle);
            #endregion

            #region 文本内容
            g.DrawString("自定义控件属性实现类型转换器之自定义类型", Font, Brushes.Black, new PointF(1, 1));
            #endregion

            #endregion
        }
    }
 
    #region 自定义类型 和 自定义类型转换器

    /// <summary>
    /// 自定义对象
    /// </summary>
    [TypeConverter(typeof(MoneyConverter))] // 为对象指出使用自定义转换器
    public class Money
    {
        private Int32 _min;
        private Int32 _max;

        [Browsable(true)]
        public Int32 Min
        {
            get { return _min; }
            set { _min = value; }
        }

        [Browsable(true)]
        public Int32 Max
        {
            get { return _max; }
            set { _max = value; }
        }

        public Money()
        {
        }

        public Money(Int32 min, Int32 max)
        {
            _min = min;
            _max = max;
        }
    }

    /// <summary>
    /// Money对象的转换器
    /// </summary>
    public class MoneyConverter : TypeConverter
    {
        /// <summary>
        /// 是否可从指定类型转换到本类型（Money）
        /// </summary>
        /// <param name="context">提供组件的上下文信息，例如 组件的容器和属性描述</param>
        /// <param name="sourceType">指定对象的类型</param>
        /// <returns>能够转换返回ture 否则返回false</returns>
        public override bool CanConvertFrom(ITypeDescriptorContext context, Type sourceType)
        {
            if (sourceType == typeof(String))
            {
                return true;
            }
            return base.CanConvertFrom(context, sourceType);
        }

        /// <summary>
        /// 从指定类型转换到本类型（Money）
        /// </summary>
        /// <param name="context">提供组件的上下文信息，例如 组件的容器和属性描述</param>
        /// <param name="culture">本地化对象</param>
        /// <param name="value">欲转换对象</param>
        /// <returns>返回转换对象</returns>
        public override object ConvertFrom(
            ITypeDescriptorContext context,
            System.Globalization.CultureInfo culture,
            object value
            )
        {
            if (value is String)
            {
                String[] strArray = ((String)value).Split(',');

                // 数组的长度为2时
                if (strArray.GetLength(0) != 2)
                {
                    throw new ArgumentException("Invalid paremeter format");
                }
                Money money = new Money();
                money.Min = Convert.ToInt32(strArray[0]);
                money.Max = Convert.ToInt32(strArray[1]);
                return money;
            }
            return base.ConvertFrom(context, culture, value);
        }

        /// <summary>
        /// 是否可以转换到指定类型
        /// </summary>
        /// <param name="context">提供组件的上下文信息，例如 组件的容器和属性描述</param>
        /// <param name="destinationType">指定装换对象的类型</param>
        /// <returns>能够转换返回ture 否则返回false</returns>
        public override bool CanConvertTo(ITypeDescriptorContext context, Type destinationType)
        {
            if (destinationType == typeof(String))
            {
                return true;
            }
            if (destinationType == typeof(InstanceDescriptor))
            {
                return true;
            }
            return base.CanConvertTo(context, destinationType);
        }

        /// <summary>
        /// 转换到指定类型
        /// </summary>
        /// <param name="context">提供组件的上下文信息，例如 组件的容器和属性描述</param>
        /// <param name="culture">本地化对象</param>
        /// <param name="value">待转换对象</param>
        /// <param name="destinationType">指定装换对象的类型</param>
        /// <returns>返回指定类型对象的实例</returns>
        public override object ConvertTo(
            ITypeDescriptorContext context,
            System.Globalization.CultureInfo culture,
            object value,
            Type destinationType
            )
        {
            String result = "";
            if (destinationType == typeof(String))
            {
                Money money = (Money)value;
                result = String.Format("{0},{1}", money.Min, money.Max);
                return result;
            }

            // 如果对象类型为InstanceDescriptor
            if (destinationType == typeof(InstanceDescriptor))
            {
                #region 使用反射构造指定类型对象的实例

                Money money = (Money)value;

                //
                // 获取构造函数信息的对象
                //
                ConstructorInfo ci = typeof(Money).GetConstructor(new Type[] { typeof(Int32), typeof(Int32) });

                //
                // 返回可序列化的对象【TypeDescriptor 的若干方法使用 InstanceDescriptor 来表示或实例化对象】
                //
                return new InstanceDescriptor(ci, new object[] { money.Min, money.Max });

                #endregion
            }
            return base.ConvertTo(context, culture, value, destinationType);
        }
    }
    #endregion
}

注意在ConvertForm方法中我们将设计时属性中输入的字符串解析为Money对象。

效果图：

image

在设计时给属性赋值的时只需输入 格式为"min，max"格式的字符串就可以对Money对象的ccMoney窗体属性赋值了。

在【实例三中】有没有发现一个问题，我对ccMoney的设置是默认规定了一个字符串格式（"min，max" ），这无论是对于使用该控件的人和程序开发人员来说都是不好的设计方法。对于Money这种复杂的对象属性来说最好自己定义一个UIEditer来为单独的子属性提供编辑功能。

好了说了这么多，类型转换器的内容基本上就这点东西了。下次我们说说如何为属性的子属性提供编辑功能。：）


threadroc
关注
专栏目录
.net中Attribute、TypeConverter、UITypeEditor的自定义--.net自定义控件属性特性配置及相关类的设计
01-04
近期使用了.net中的PropertyGrid，通过多方资料例子，感觉有所收获，特将一些心得分享一下： 1、例子展示了属性的各个特性（ReadOnly、Browsable、Category、Description、TypeConverter、Editor、DefaultValue、DisplayName）的效果。 2、例子中实现了一个自定义的Editor：AlignModeUITypeEditor，以支持自定义的属性设计器。 3、例子中实现了一个自定义的Attribute：DisplayNameAttribute和一个自定一个TypeConverter：EnumConverter，以支持显示的值与实际选中的值可以不同并一一对应。 注意，各个属性均是自己定义的一个枚举类型AlignMode。 查看各个属性并注意下方的说明，再结合源代码，你一定会有很大的收获。 可以通过：http://blog.tglgx.cn/post/2010/01/04/usercontrol_Attribute_TypeConverter_UITypeEditor_PropertyGrid.aspx 免分下载
C# Winform PropertyGrid显示中文
最新发布
那人那事的博客
07-04 309
主要原理是在枚举上添加DescriptionAttribute属性，然后通过反射将其显示出来。方法1：继承StringConverter类。方法2：自定义界面显示。
深度解析 TypeConverter & TypeConverterAttribute （二）
weixin_30322405的博客
12-12 277
TypeConverterAttribute Class TypeConverterAttribute 其实就是一个继承Attribute的类，使用[TypeConverter(typeof(MyClassConverter))]标签施加到程序实体上。根据TypeConverterAttritue的定义知道这个属性Attribute可以施加到所有实体上。 [AttributeU...
[转]深度解析 TypeConverter & TypeConverterAttribute
weixin_34097242的博客
06-02 300
原文地址:http://www.cnblogs.com/ericwen/archive/2007/12/11/TypeConverter.html 前言    我们在开发复杂控件的时候不可避免的碰到类型转换TypeConverter，微软给我们提供了很多转换类如ArrayConverter，BaseNumberConverter，BooleanConverter（MSDN上更多：ms-help:...
.NET组件编程（5） TypeConverterAttribute，类型转换
ajw1282的博客
03-20 361
上一篇文章是03-08写的，距离今天已经有十多天了没有写了，主要是最近太忙了，而且在工作上遇到了一些难点，所以没有时间放在blog上，实在是对不住大家。 今天的这篇文章，我主要是带来PropertyAttribute里的TypeConverterAttribute的讲解，首先在这里讲讲TypeConverterAttribute的作用是什么：当Compone...
WinForm窗体及其控件的自适应,winform控件随窗口自适应,C#
09-10
在Windows Forms（WinForm）开发中，用户界面的自适应性是提高应用程序用户体验的关键因素之一。自适应设计可以使应用程序在不同尺寸的屏幕上看起来更加整洁、专业，并且易于使用。本篇将深入探讨如何实现WinForm...
C#编程 WinForm窗体开发 Selected(源码)
07-01
C#编程 WinForm窗体开发 Selected(源码)C#编程 WinForm窗体开发 Selected(源码)C#编程 WinForm窗体开发 Selected(源码)C#编程 WinForm窗体开发 Selected(源码)C#编程 WinForm窗体开发 Selected(源码)C#编程 WinForm...
C# WinForm 窗体中控件的大小自适应
11-14
下载后解压缩即可运行使用，代码...3.为窗体添加SizeChanged事件，并在其方法Form1_SizeChanged中，首次记录窗体和其控件初始位置和大小，之后调用类的自适应方法，完成自适应。 4.Panel,DataGridView等控件同样适用。
C#语言，Winform窗体，Access库，实现用户登录与注册、数据增删改查、可以直接在DataGridView控件修改
08-06
实现了数据在不同窗体上传递，具体可看项目中文件LoginInfo.cs的用法，该项目中还巧妙的连接数据库，因为如果使用Winform窗体连接Access本地数据库的家人就会知道，方法就是用路劲，就发现如果你的数据库位置在你...
C#实现winform用子窗体刷新父窗体及子窗体改变父窗体控件值的方法
09-03
在C# WinForm开发中，有时我们需要在子窗体中操作或更新父窗体的状态，例如刷新父窗体内容或更改父窗体上的控件值。以下两种方法详细阐述了如何实现这一目标。 **方法一：使用委托** 在这种方法中，我们通过定义一...
TypeConverter源码实现
02-15
PropertyGrid 中true false显示成是 否，实现的主要方式是重载TypeConverter类
winform控件学习[TypeConverter(typeof(ScopeConverter))]
weixin_30439131的博客
10-15 283
using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.ComponentModel; using System.Windows.Forms; using System.Drawing; using System.ComponentMode...
深度解析 TypeConverter & TypeConverterAttribute （一）
重文-技艺山海经
08-28 1072
前言     我们在开发复杂控件的时候不可避免的碰到类型转换TypeConverter，微软给我们提供了很多转换类如ArrayConverter，BaseNumberConverter，BooleanConverter（MSDN上更多：ms-help://MS.MSDNQTR.v80.en/MS.MSDN.v80/MS.NETDEVFX.v20.en/cpref3/html/N_Syst
Winforms：TypeConverter.IsValid中的改动
何海涛的专栏
06-27 4743
本文讨论了TypeConverter.IsValid在.NET 2.0中不管传入参数始终返回true的原因，以及该方法在.NET 4.0中作的修改。修改之后的TypeConverter.IsValid将判断输入的参数对于转换的目标参数是否有效，只在有效的时候返回true.
WinForm控件开发总结(六)-----控件属性类型转换器代码详解
weixin_34392843的博客
12-14 90
      在上一篇文章，我为控件添加一个一个复杂属性，并且为这个属性的类型的编写了一个类型转换器，现在我们来看看这个类型转换器的代码，并解释一下这些代码的意义。       要实现一个类型转换器，我们必须要重写（override）四个方法：       CanConvertFrom（）――根据类型参数进行测试，判断是否能从这个类型转换成当前类型,在本例中我们只提供转换string和Instanc...
重写 TypeConverter 时，自定义子属性顺序
成不了佛,便堕落吧
03-16 1189
重写 TypeConverter 时，如果子属性需要按一定的顺序 public override PropertyDescriptorCollection GetProperties(ITypeDescriptorContext context, object value, Attribute[] attributes) { Strin
TypeConverter学习
aikuo9061的博客
09-22 137
之前的一个封装读取配置文件类 中，CommonHelper.To() 方法实现类型的转换,用到了TypeConverter 类。学习记录一下用法。 TypeConverter 实现两个类的互相转换。 通过继承TypeConverter按需实现4个方法来实现自定义类型转换。 public virtual object ConvertFrom(System.ComponentM...
WinForm控件开发总结(五)-----为控件的复杂属性提供类型转换器
上帝狼
09-09 386
上一篇文章我已经介绍了TypeConverterAttribute元数据的作用，本文将通过代码向你展示具体的实现。在这个例子中，我要给控件添加一个复杂的属性，这个属性对这个控件没有什么功用，纯粹是为了演示，有些牵强附会了。 　　 现在在前一篇文章中的创建的控件代码中添加一个Sc
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值