EnumConverter 类

定义

命名空间:

System.ComponentModel

程序集:

System.ComponentModel.TypeConverter.dll

Source:

EnumConverter.cs

提供将 Enum 对象与其他各种表示形式相互转换的类型转换器。

public ref class EnumConverter : System::ComponentModel::TypeConverter

public class EnumConverter : System.ComponentModel.TypeConverter

type EnumConverter = class
    inherit TypeConverter

Public Class EnumConverter
Inherits TypeConverter

继承

Object

TypeConverter

EnumConverter

派生

System.Drawing.FontConverter.FontUnitConverter

示例

下面的代码示例将 类型的 Enum 变量转换为字符串，反之亦然。 该示例要求你已声明了一Servers个名为 Enum 且具有以下成员：

Windows=1, Exchange=2, BizTalk=3  

// Requires public declaration of the following type.
// __value enum Servers {Windows=1, Exchange=2, BizTalk=3};
Servers myServer = Servers::Exchange;
String^ myServerString = "BizTalk";
Console::WriteLine( TypeDescriptor::GetConverter( myServer )->ConvertTo( myServer, String::typeid ) );
Console::WriteLine( TypeDescriptor::GetConverter( myServer )->ConvertFrom( myServerString ) );

Enum myServer= Servers.Exchange;
string myServerString = "BizTalk";
Console.WriteLine(TypeDescriptor.GetConverter(myServer).ConvertTo(myServer, typeof(string))); 
Console.WriteLine(TypeDescriptor.GetConverter(myServer).ConvertFrom(myServerString));

Dim myServer As Servers = Servers.Exchange
Dim myServerString As string = "BizTalk"
Console.WriteLine(TypeDescriptor.GetConverter(myServer).ConvertTo(myServer, GetType(String))) 
Console.WriteLine(TypeDescriptor.GetConverter(myServer).ConvertFrom(myServerString))

注解

此转换器只能将枚举对象与字符串进行转换和转换。 类 EnumConverter 提供 Comparer 属性以获取 IComparer 可用于对枚举的值进行排序的接口。 默认情况下，枚举值按它们在文件中出现的顺序进行排序。

有关类型转换器的详细信息，请参阅 TypeConverter 基类和 如何：实现类型转换器。

注意

不应创建 的 EnumConverter实例。 而应调用 GetConverter 类的 TypeDescriptor 方法。 有关详细信息，请参阅基类中的 TypeConverter 示例。

继承者说明

如果要按不同的顺序对值进行排序，请重写 Comparer 属性。

构造函数

EnumConverter(Type)

为给定类型初始化 EnumConverter 类的新实例。

属性

Comparer	获取可用于对枚举的值进行排序的 IComparer。
EnumType	指定与此转换器关联的枚举数的类型。
Values	获取或设置一个 TypeConverter.StandardValuesCollection，用来为枚举指定可能的值。

方法

CanConvertFrom(ITypeDescriptorContext, Type)	获取一个值，该值指示此转换器是否可使用指定上下文将给定源类型的对象转换为枚举对象。
CanConvertFrom(Type)	返回该转换器是否可以将给定类型的对象转换为此转换器的类型。 (继承自 TypeConverter)
CanConvertTo(ITypeDescriptorContext, Type)	获取一个值，该值指示此转换器能否使用上下文将对象转换为给定的目标类型。
CanConvertTo(Type)	返回此转换器是否可将该对象转换为指定的类型。 (继承自 TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)	将指定的值对象转换为枚举对象。
ConvertFrom(Object)	将给定值转换为此转换器的类型。 (继承自 TypeConverter)
ConvertFromInvariantString(ITypeDescriptorContext, String)	使用不变区域性和指定上下文将给定字符串转换为此转换器的类型。 (继承自 TypeConverter)
ConvertFromInvariantString(String)	使用不变区域性将给定字符串转换为此转换器的类型。 (继承自 TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)	使用指定的上下文和区域性信息将给定的文本转换为对象。 (继承自 TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)	使用指定的上下文将给定的文本转换为对象。 (继承自 TypeConverter)
ConvertFromString(String)	将指定文本转换为对象。 (继承自 TypeConverter)
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)	将给定的值对象转换为指定的目标类型。
ConvertTo(Object, Type)	使用参数将给定的值对象转换为指定的类型。 (继承自 TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)	使用指定的上下文将指定的值转换为区域性不变的字符串表示形式。 (继承自 TypeConverter)
ConvertToInvariantString(Object)	将指定值转换为区域性不变的字符串表示形式。 (继承自 TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)	使用指定的上下文和区域性信息将给定的值转换为字符串表示形式。 (继承自 TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)	使用给定的上下文将给定的值转换为字符串表示形式。 (继承自 TypeConverter)
ConvertToString(Object)	将指定值转换为字符串表示形式。 (继承自 TypeConverter)
CreateInstance(IDictionary)	在给定 Object 的一组属性值的情况下重新创建该对象。 (继承自 TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)	给定该对象的一组属性值，使用指定上下文创建与此 TypeConverter 相关联的类型的实例。 (继承自 TypeConverter)
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetConvertFromException(Object)	返回当转换无法执行时所引发的异常。 (继承自 TypeConverter)
GetConvertToException(Object, Type)	返回当转换无法执行时所引发的异常。 (继承自 TypeConverter)
GetCreateInstanceSupported()	返回更改此对象的值是否求调用 CreateInstance(IDictionary) 方法来创建新值。 (继承自 TypeConverter)
GetCreateInstanceSupported(ITypeDescriptorContext)	返回一个结果，即更改此对象上的某个值是否需要调用 CreateInstance(IDictionary) 以使用指定的上下文创建新值。 (继承自 TypeConverter)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetProperties(ITypeDescriptorContext, Object)	使用指定的上下文返回值参数指定的数组类型的属性的集合。 (继承自 TypeConverter)
GetProperties(ITypeDescriptorContext, Object, Attribute[])	使用指定的上下文和特性返回由该值参数指定的数组类型的属性集合。 (继承自 TypeConverter)
GetProperties(Object)	返回由值参数指定的数组类型的属性集合。 (继承自 TypeConverter)
GetPropertiesSupported()	返回此对象是否支持属性。 (继承自 TypeConverter)
GetPropertiesSupported(ITypeDescriptorContext)	通过使用指定的上下文，返回此对象是否支持属性。 (继承自 TypeConverter)
GetStandardValues()	从默认的上下文返回此类型转换器设计用于的数据类型的标准值集合。 (继承自 TypeConverter)
GetStandardValues(ITypeDescriptorContext)	获取此验证器设计用于的数据类型的标准值集合。
GetStandardValuesExclusive()	返回从 GetStandardValues() 返回的标准值的集合是否为独占列表。 (继承自 TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)	获取一个值，该值指示从 GetStandardValues() 返回的标准值的列表是不是使用指定上下文的独占列表。
GetStandardValuesSupported()	返回此对象是否支持可以从列表中选取的标准值集。 (继承自 TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)	获取一个值，该值指示此对象是否支持可使用指定上下文从列表中选取的标准值集。
GetType()	获取当前实例的 Type。 (继承自 Object)
IsValid(ITypeDescriptorContext, Object)	获取一个用于指示给定对象值是否对此类型有效的值。
IsValid(Object)	返回给定值对象对于此类型是否有效。 (继承自 TypeConverter)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
SortProperties(PropertyDescriptorCollection, String[])	对属性的集合进行排序。 (继承自 TypeConverter)
ToString()	返回表示当前对象的字符串。 (继承自 Object)