Console.WriteLine("**** Fun with Enums *****");
...
// Вывести тип хранилища для значений перечисления.
Console.WriteLine("EmpTypeEnum uses a {0} for storage",
Enum.GetUnderlyingType(emp.GetType()));
Console.ReadLine();
Метод
Enum.GetUnderlyingType()
требует передачи
System.Type
в качестве первого параметра. В главе 15 будет показано, что класс
Туре
представляет описание метаданных для конкретной сущности .NET Core.
Один из возможных способов получения метаданных (как демонстрировалось ранее) предусматривает применение метода
GetType()
, который является общим для всех типов в библиотеках базовых классов .NET Core. Другой подход заключается в использовании операции
typeof
языка С#. Преимущество такого способа связано с тем, что он не требует объявления переменной сущности, описание метаданных которой требуется получить:
// На этот раз для получения информации о типе используется операция typeof
Console.WriteLine("EmpTypeEnum uses a {0} for storage",
Enum.GetUnderlyingType(typeof(EmpTypeEnum)));
Динамическое обнаружение пар "имя-значение" перечисления
Кроме метода
Enum.GetUnderlyingType()
все перечисления C# поддерживают метод по имени
ToString()
, который возвращает строковое имя текущего значения перечисления. Ниже приведен пример:
EmpTypeEnum emp = EmpTypeEnum.Contractor;
...
// Выводит строку "emp is a Contractor."
Console.WriteLine("emp is a {0}.", emp.ToString());
Console.ReadLine();
Если интересует не имя, а значение заданной переменной перечисления, то можно просто привести ее к лежащему в основе типу хранилища, например:
Console.WriteLine("**** Fun with Enums *****");
EmpTypeEnum emp = EmpTypeEnum.Contractor;
...
// Выводит строку "Contractor = 100".
Console.WriteLine("{0} = {1}", emp.ToString(), (byte)emp);
Console.ReadLine();
На заметку! Статический метод
Enum.Format()
предлагает более высокий уровень форматирования за счет указания флага желаемого формата. Полный список флагов форматирования ищите в документации.
В типе
System.Enum
определен еще один статический метод по имени
GetValues()
, возвращающий экземпляр класса
System.Array
. Каждый элемент в массиве соответствует члену в указанном перечислении. Рассмотрим следующий метод, который выводит на консоль пары "имя-значение" из перечисления, переданного в качестве параметра:
// Этот метод выводит детали любого перечисления.
static void EvaluateEnum(System.Enum e)
{
Console.WriteLine("=> Information about {0}", e.GetType().Name);
// Вывести лежащий в основе тип хранилища.
Console.WriteLine("Underlying storage type: {0}",
Enum.GetUnderlyingType(e.GetType()));
// Получить все пары "имя-значение" для входного параметра.
Array enumData = Enum.GetValues(e.GetType());
Console.WriteLine("This enum has {0} members.", enumData.Length);
// Вывести строковое имя и ассоциированное значение,
// используя флаг формата D (см. главу 3).
for(int i = 0; i < enumData.Length; i++)
{
Console.WriteLine("Name: {0}, Value: {0:D}",
enumData.GetValue(i));
}
}
Чтобы протестировать метод
EvaluateEnum()
, модифицируйте код для создания переменных нескольких типов перечислений, объявленных в пространстве имен
System
(вместе с перечислением
EmpTypeEnum
):
Console.WriteLine("**** Fun with Enums *****");
...
EmpTypeEnum e2 = EmpType.Contractor;
// Эти типы являются перечислениями из пространства имен System.
DayOfWeek day = DayOfWeek.Monday;
ConsoleColor cc = ConsoleColor.Gray;
EvaluateEnum(e2);
EvaluateEnum(day);
EvaluateEnum(cc);
Console.ReadLine();
Ниже показана часть вывода:
=> Information about DayOfWeek
Underlying storage type: System.Int32
This enum has 7 members.
Name: Sunday, Value: 0
Name: Monday, Value: 1
Name: Tuesday, Value: 2
Name: Wednesday, Value: 3
Name: Thursday, Value: 4
Name: Friday, Value: 5
Name: Saturday, Value: 6
В ходе чтения книги вы увидите, что перечисления широко применяются во всех библиотеках базовых классов .NET Core. При работе с любым перечислением всегда помните о возможности взаимодействия с парами "имя-значение", используя члены класса
System.Enum
.