Должен ли Enum начинаться с 0 или 1?

Представьте, что я определил следующее Enum:

public enum Status : byte
{
    Inactive = 1,
    Active = 2,
}

Как лучше всего использовать enum? Должно ли оно начинаться с 1примера, приведенного выше, или начинаться с 0(без явных значений) следующим образом:

public enum Status : byte
{
    Inactive,
    Active
}

Руководство по проектированию рамок :

✔️ НЕОБХОДИМО указывать нулевое значение для простых перечислений.

Подумайте над тем, чтобы назвать это значение как «Нет». Если такое значение не подходит для данного конкретного перечисления, наиболее распространенному значению по умолчанию для перечисления должно быть присвоено базовое значение ноль.

Руководство по проектированию рамок / Разработка перечислений флагов :

❌ ИЗБЕГАЙТЕ, используя значения перечисления флага, равные нулю, если только это значение не представляет «все флаги очищены» и не названо соответствующим образом, как предписано в следующем руководстве.

✔️ НУЖНО назвать нулевое значение перечислений флагов Нет. Для перечисления флагов значение всегда должно означать «все флаги очищены».

Ну, я полагаю, что я не согласен с большинством ответов, в которых говорится, что я не должен их явно перечислять. Я всегда явно их нумерую, но это потому, что в большинстве случаев я сохраняю их в потоке данных, где они хранятся как целочисленные значения. Если вы не добавите значения явно, а затем добавите новое значение, вы можете прервать сериализацию, а затем не сможете точно загрузить старые сохраненные объекты. Если вы собираетесь делать какие-либо постоянные хранилища этих значений, я настоятельно рекомендую явно установить значения.

Enum является типом значения, и его значение по умолчанию (например, для поля Enum в классе) будет 0, если не инициализировано явно.

Поэтому вы обычно хотите иметь 0 в качестве определенной константы (например, Неизвестно).

В вашем примере, если вы хотите Inactiveбыть значением по умолчанию, тогда оно должно иметь значение ноль. В противном случае вы можете рассмотреть возможность добавления константы Unknown.

Некоторые люди рекомендуют вам не указывать явно значения для ваших констант. Вероятно, в большинстве случаев это хороший совет, но в некоторых случаях вы захотите это сделать:

• Флаги перечислений

• Перечисления, значения которых используются во взаимодействии с внешними системами (например, COM).

Если у вас нет особых причин изменить его, оставьте перечисления со значениями по умолчанию, которые начинаются с нуля.

public enum Status : byte
{
    Inactive,
    Active
}

Я бы сказал, что лучшая практика - не нумеровать их и позволять им быть неявными - что начиналось бы с 0. Поскольку это неявное, это языковые предпочтения, которым всегда хорошо следовать :)

Я бы начал перечисление логического типа с 0.

Если только «Inative» означает нечто иное, чем «Inactive» :)

Это сохраняет стандарт для тех.

Я бы сказал, это зависит от того, как вы их используете. Для пометки enum рекомендуется иметь Noneзначение 0 , например:

[Flags]
enum MyEnum
{
    None = 0,
    Option1 = 1,
    Option2 = 2,
    Option3 = 4,
    All = Option1 | Option2 | Option3,
}

Когда ваше перечисление может быть сопоставлено с таблицей поиска в базе данных, я бы начал с 1. Это не должно иметь большого значения для профессионально написанного кода, но это улучшает читаемость.

В других случаях я бы оставил все как есть, не заботясь о том, начинаются ли они с 0 или 1.

Если у вас нет веской причины для использования необработанных значений, вам следует использовать только неявные значения и ссылаться на них с помощью Status.Activeи Status.Inactive.

Суть в том, что вы можете хранить данные в плоском файле или БД или использовать плоский файл или БД, созданные кем-то другим. Если вы делаете это самостоятельно, сделайте так, чтобы нумерация соответствовала тому, для чего используется Enum.

Если данные не ваши, конечно, вы захотите использовать то, что исходный разработчик использовал в качестве схемы нумерации.

Если вы планируете использовать Enum в качестве набора флагов, есть простое соглашение, которое стоит придерживаться:

enum Example
{
  None      = 0,            //  0
  Alpha     = 1 << 0,       //  1
  Beta      = 1 << 1,       //  2
  Gamma     = 1 << 2,       //  4
  Delta     = 1 << 3,       //  8
  Epsilon   = 1 << 4,       // 16
  All       = ~0,           // -1
  AlphaBeta = Alpha | Beta, //  3
}

Значения должны быть степенью двойки и могут быть выражены с использованием операций сдвига битов. None, очевидно, должно быть 0, но Allменее очевидно -1. ~0является двоичным отрицанием 0и приводит к числу, для которого установлен каждый бит 1, который представляет значение-1 . Для составных флагов (часто используемых для удобства) другие значения могут быть объединены с использованием побитового или оператора |.

Не назначайте никаких номеров. Просто используйте его так, как он должен быть использован.

Если не указано, нумерация начинается с 0.

Важно быть явным, поскольку перечисления часто сериализуются и хранятся как int, а не как строка.

Для любого перечисления, хранящегося в базе данных, мы всегда явно нумеруем опции, чтобы предотвратить смещение и переназначение во время обслуживания.

Согласно Microsoft, рекомендуемое соглашение - использовать первый нулевой параметр для представления неинициализированного или наиболее распространенного значения по умолчанию.

Ниже приведен ярлык для начала нумерации с 1 вместо 0.

public enum Status : byte
{
    Inactive = 1,
    Active
}

Если вы хотите установить значения флага для использования битовых операторов в значениях перечисления, не начинайте нумерацию с нулевого значения.

Если вы начнете с 1, то вы можете легко получить количество ваших вещей.

{
    BOX_THING1     = 1,
    BOX_THING2     = 2,
    BOX_NUM_THING  = BOX_THING2
};

Если вы начинаете с 0, то используйте первый как значение для неинициализированных вещей.

{
    BOX_NO_THING   = 0,
    BOX_THING1     = 1,
    BOX_THING2     = 2,
    BOX_NUM_THING  = BOX_THING2
};

Прежде всего, если вы не указываете конкретные значения по какой-либо причине (числовое значение имеет значение где-то еще, например, База данных или внешняя служба), тогда вообще не указывайте числовые значения и не допускайте их явного указания.

Во-вторых, у вас всегда должен быть элемент с нулевым значением (в перечислении без флагов). Этот элемент будет использоваться в качестве значения по умолчанию.

Не начинайте их с 0, если для этого нет причин, таких как использование их в качестве индексов для массива или списка, или если есть какая-то другая практическая причина (например, использование их в побитовых операциях).

Вы enumдолжны начать именно там, где это необходимо. Это также не должно быть последовательным. Значения, если они установлены явно, должны отражать некоторое семантическое значение или практическое рассмотрение. Например, enum«бутылки на стене» должны быть пронумерованы от 1 до 99, в то время как enumдля степеней 4, вероятно, они должны начинаться с 4 и продолжаться с 16, 64, 256 и т. Д.

Кроме того, добавление элемента с нулевым значением в элемент enumследует выполнять только в том случае, если он представляет допустимое состояние. Иногда «нет», «неизвестно», «отсутствует» и т. Д. Являются допустимыми значениями, но часто это не так.

Я предпочитаю начинать перечисления с 0, так как это значение по умолчанию, но я также хотел бы включить значение Unknown со значением -1. Это тогда становится значением по умолчанию и может иногда помочь с отладкой.