Condividi tramite


Procedura: dichiarare enumerazioni (Visual Basic)

Si crea un'enumerazione con l'istruzione Enum nella sezione di dichiarazioni di una classe o di un modulo. Non è possibile dichiarare un'enumerazione all'interno di un metodo. Per specificare il livello di accesso appropriato, usare Private, Protected, Friend o Public.

Un tipo Enum ha un nome, un tipo sottostante e un set di campi, ognuno dei quali rappresenta una costante. Il nome deve essere un qualificatore .NET di Visual Basic valido. Il tipo sottostante deve essere uno dei tipi Integer: Byte, Short, Long o Integer. Integer è l'impostazione predefinita. Le enumerazioni sono sempre fortemente tipizzate e non sono intercambiabili con tipi di numeri interi.

Le enumerazioni non possono avere valori a virgola mobile. Se a un'enumerazione viene assegnato un valore a virgola mobile con Option Strict On, viene restituito un errore del compilatore. Se Option Strict è Off, il valore viene convertito automaticamente nel tipo Enum.

Per informazioni sui nomi e su come usare l'istruzione Imports per rendere superflua la qualificazione dei nomi, vedere Enumerazioni e qualificazione dei nomi.

Per dichiarare un'enumerazione

  1. Scrivere una dichiarazione che include un livello di accesso al codice, la parola chiave Enum e un nome valido, come negli esempi seguenti, ognuno dei quali dichiara un oggetto Enum diverso.

    Private Enum SampleEnum
        SampleMember
    End Enum
    Public Enum SampleEnum2
        SampleMember
    End Enum
    Protected Enum SampleEnum3
        SampleMember
    End Enum
    Friend Enum SampleEnum4
        SampleMember
    End Enum
    Protected Friend Enum SampleEnum5
        SampleMember
    End Enum
    
  2. Definire le costanti nell'enumerazione. Per impostazione predefinita, la prima costante in un'enumerazione viene inizializzata su 0 e le costanti successive vengono inizializzate su un valore maggiore di uno rispetto alla costante precedente. Ad esempio, l'enumerazione seguente, Days, contiene una costante denominata Sunday con il valore 0, una costante denominata Monday con il valore 1, una costante denominata Tuesday con il valore di 2 e così via.

    Public Enum Days
        Sunday
        Monday
        Tuesday
        Wednesday
        Thursday
        Friday
        Saturday
    End Enum
    
  3. È possibile assegnare in modo esplicito valori alle costanti in un'enumerazione usando un'istruzione di assegnazione. È possibile assegnare qualsiasi valore intero, inclusi i numeri negativi. Ad esempio, è possibile specificare costanti con valori minori di zero per rappresentare condizioni di errore. Nell'enumerazione seguente, alla costante Invalid viene assegnato in modo esplicito il valore –1 e alla costante Sunday viene assegnato il valore 0. Poiché è la prima costante nell'enumerazione, anche Saturday viene inizializzata sul valore 0. Il valore di Monday è 1 (il valore di Sunday più uno); il valore di Tuesday è 2 e così via.

    Public Enum WorkDays
        Saturday
        Sunday = 0
        Monday
        Tuesday
        Wednesday
        Thursday
        Friday
        Invalid = -1
    End Enum
    

Per dichiarare un'enumerazione come tipo esplicito

  • Specificare il tipo di enumerazione usando la clausola As, come illustrato nell'esempio seguente.

    Public Enum MyEnum As Byte
        Zero
        One
        Two
    End Enum
    

Vedi anche