EnumConverter Класс

Ссылка

Определение

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

Сборка:: System.ComponentModel.TypeConverter.dll

Сборка:: System.dll

Сборка:: netstandard.dll

Исходный код:: EnumConverter.cs

Исходный код:: EnumConverter.cs

Исходный код:: 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 преобразуется в строку и наоборот. В этом примере требуется, чтобы вы объявили вызываемого EnumServers объекта и что он содержит следующие члены:

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[])	Возвращает коллекцию свойств для типа массива, заданного параметром value, используя заданные контекст и атрибуты. (Унаследовано от 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)

Применяется к

Продукт	Версии
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

Совместная работа с нами на GitHub

Источник этого содержимого можно найти на GitHub, где также можно создавать и просматривать проблемы и запросы на вытягивание. Дополнительные сведения см. в нашем руководстве для участников.

Отзыв о .NET

.NET — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв:

Открыть проблему с документацией Отзыв о продукте

Будущее в ваших руках

Поделиться через