Un Enum dovrebbe iniziare con uno 0 o un 1?

Immagina di aver definito il seguente Enum:

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

Qual è la migliore pratica per usare enum? Dovrebbe iniziare 1come nell'esempio precedente o iniziare 0(senza i valori espliciti) in questo modo:

public enum Status : byte
{
    Inactive,
    Active
}

Linee guida per la progettazione del framework :

✔️ Fornisce un valore pari a zero su enumerazioni semplici.

Valuta di chiamare il valore in modo simile a "Nessuno". Se tale valore non è appropriato per questo particolare enum, al valore predefinito più comune per l'enum dovrebbe essere assegnato il valore sottostante pari a zero.

Linee guida per la progettazione di quadri / Progettazione di enumerazioni di bandiere :

❌ EVITARE di utilizzare valori di enum di flag pari a zero, a meno che il valore non rappresenti "vengono cancellati tutti i flag" e sia denominato in modo appropriato, come prescritto dalla linea guida successiva.

✔️ DO nome il valore zero di enumerazioni bandiera Nessuno. Per un enum di flag, il valore deve sempre significare "tutte le flag vengono cancellate".

Bene, immagino di essere in disaccordo con la maggior parte delle risposte che dicono di non numerarle esplicitamente. Li scrivo sempre in modo esplicito, ma ciò accade perché nella maggior parte dei casi finisco per persistere in un flusso di dati in cui sono memorizzati come valore intero. Se non si aggiungono esplicitamente i valori e quindi si aggiunge un nuovo valore, è possibile interrompere la serializzazione e non essere in grado di caricare con precisione vecchi oggetti persistenti. Se hai intenzione di fare qualsiasi tipo di archivio persistente di questi valori, ti consiglio vivamente di impostare esplicitamente i valori.

Un Enum è un tipo di valore e il suo valore predefinito (ad esempio per un campo Enum in una classe) sarà 0 se non inizializzato esplicitamente.

Pertanto in genere si desidera avere 0 come costante definita (ad es. Sconosciuto).

Nel tuo esempio, se vuoi Inactiveessere il valore predefinito, dovrebbe avere il valore zero. Altrimenti potresti considerare di aggiungere una costante Unknown.

Alcune persone hanno raccomandato di non specificare esplicitamente i valori per le costanti. Probabilmente un buon consiglio nella maggior parte dei casi, ma ci sono alcuni casi in cui vorrai farlo:

• Flag enums

• Enum i cui valori sono usati in interoperabilità con sistemi esterni (es. COM).

A meno che tu non abbia un motivo specifico per cambiarlo, lascia enum con i loro valori predefiniti, che iniziano da zero.

public enum Status : byte
{
    Inactive,
    Active
}

Direi che la migliore pratica è non numerarli e lasciare che sia implicito - che inizierebbe da 0. Dal momento che è implicito è la preferenza linguistica che è sempre buona seguire :)

Vorrei iniziare un enum di tipo booleano con uno 0.

A meno che "Inativo" significhi qualcosa di diverso da "Inattivo" :)

Questo mantiene lo standard per quelli.

Direi che dipende da come li usi. Per segnalare l'enumerazione è buona norma avere 0 per Nonevalore, come quello:

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

Quando è probabile che il tuo enum sia mappato su una tabella di ricerca del database, lo inizierei con 1. Non dovrebbe importare molto per il codice scritto professionalmente, ma questo migliora la leggibilità.

In altri casi lo lascerei così com'è, non importa se iniziano con 0 o 1.

A meno che tu non abbia una buona ragione per usare i valori grezzi, dovresti sempre e solo usare valori impliciti e fare riferimento a loro con Status.Activee Status.Inactive.

Il problema è che potresti voler archiviare i dati in un file flat o DB, oppure utilizzare un file flat o DB creato da qualcun altro. Se lo fai tu stesso, fallo in modo che la numerazione si adatti a ciò per cui Enum è usato.

Se i dati non sono tuoi, ovviamente vorrai usare qualunque cosa il dev originale abbia usato come schema di numerazione.

Se stai pensando di usare l'Enum come un set di flag, c'è una semplice convenzione che vale la pena seguire:

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
}

I valori dovrebbero essere potenze di due e possono essere espressi usando operazioni di bit-shift. None, ovviamente dovrebbe essere 0, ma Allè meno ovviamente -1. ~0è la negazione binaria di 0e risulta in un numero su cui è impostato ogni bit 1, che rappresenta un valore di-1 . Per i flag composti (spesso usati per comodità) altri valori possono essere uniti usando bit per bit o operatore |.

Non assegnare alcun numero. Usalo come dovrebbe essere usato.

Se non specificato, la numerazione inizia da 0.

È importante essere espliciti poiché gli enum sono spesso serializzati e memorizzati come int, non come stringa.

Per ogni enum archiviato nel database, numeriamo sempre in modo esplicito le opzioni per impedire spostamenti e riassegnazioni durante la manutenzione.

Secondo Microsoft, la convenzione consigliata è utilizzare la prima opzione zero per rappresentare un valore predefinito non inizializzato o il più comune.

Di seguito è riportato un collegamento per iniziare la numerazione da 1 invece di 0.

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

Se si desidera impostare i valori flag per utilizzare gli operatori bit sui valori enum, non iniziare la numerazione sul valore zero.

Se inizi da 1, puoi facilmente ottenere un conteggio delle tue cose.

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

Se inizi da 0, usa il primo come valore per le cose non inizializzate.

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

Prima di tutto, a meno che non si specifichino valori specifici per un motivo (il valore numerico ha significato altrove, ad esempio il database o il servizio esterno), non specificare affatto valori numerici e lasciarli espliciti.

In secondo luogo, dovresti sempre avere un oggetto di valore zero (in enumerazioni senza flag). Tale elemento verrà utilizzato come valore predefinito.

Non avviarli su 0 a meno che non ci sia una ragione per, come usarli come indici in un array o in una lista, o se c'è qualche altro motivo pratico (come usarli in operazioni bit a bit).

Il tuo enumdovrebbe iniziare esattamente dove è necessario. Non deve essere neppure sequenziale. I valori, se impostati esplicitamente, devono riflettere un significato semantico o una considerazione pratica. Ad esempio, una enumdelle "bottiglie sul muro" dovrebbe essere numerata da 1 a 99, mentre una enumper i poteri di 4 dovrebbe probabilmente iniziare da 4 e continuare con 16, 64, 256, ecc.

Inoltre, aggiungere un elemento a valore zero a enumdovrebbe essere fatto solo se rappresenta uno stato valido. A volte "nessuno", "sconosciuto", "mancante" ecc. Sono valori validi, ma molte volte non lo sono.

Mi piace iniziare le mie enumerazioni su 0, dato che è l'impostazione predefinita, ma mi piace anche includere un valore Unknown, con un valore -1. Questo diventa quindi il valore predefinito e può aiutare a volte con il debug.