EnumConverter 类

定义

命名空间:

System.ComponentModel

程序集:

netstandard.dll, 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 变量转换为字符串，反之亦然。 该示例要求你声明了一个 Enum 调用， Servers 并且它具有以下成员：

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, Attribute[])	使用指定的上下文和属性返回由值参数指定的数组类型的属性集合。 (继承自 TypeConverter)
GetProperties(ITypeDescriptorContext, Object)	使用指定的上下文返回由值参数指定的数组类型的属性集合。 (继承自 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)