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
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 oggettoEnum
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
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 denominataSunday
con il valore0
, una costante denominataMonday
con il valore1
, una costante denominataTuesday
con il valore di2
e così via.Public Enum Days Sunday Monday Tuesday Wednesday Thursday Friday Saturday End Enum
È 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 costanteSunday
viene assegnato il valore0
. Poiché è la prima costante nell'enumerazione, ancheSaturday
viene inizializzata sul valore0
. Il valore diMonday
è1
(il valore diSunday
più uno); il valore diTuesday
è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
- Qualifica di nomi ed enumerazioni
- Procedura: Fare riferimento a un membro di enumerazione
- Procedura: Eseguire l'iterazione di un'enumerazione in Visual Basic
- Procedura: Determinare la stringa associata a un valore di enumerazione
- Quando usare un'enumerazione
- Cenni preliminari sulle costanti
- Tipi di dati costanti e letterali
- Costanti ed enumerazioni