Procedura: dichiarare enumerazioni (Visual Basic)

  • Articolo

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