EnumConverter Класс

Определение

Пространство имен:

System.ComponentModel

Сборки:

netstandard.dll, System.ComponentModel.TypeConverter.dll

Исходный код:

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)