Язык программирования C#9 и платформа .NET5 - Троелсен Эндрю

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. Каждый элемент в массиве соответствует члену в указанном перечислении. Рассмотрим следующий метод, который выводит на консоль пары "имя-значение" из перечисления, переданного в качестве параметра:

(window.adrunTag = window.adrunTag || []).push({v: 1, el: 'adrun-4-390', c: 4, b: 390})

// Этот метод выводит детали любого перечисления.

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.