Comment : déclarer des énumérations (Visual Basic)
Vous créez une énumération avec l’instruction Enum
dans la section déclarations d’une classe ou d’un module. Vous ne pouvez pas déclarer une énumération dans une méthode. Pour spécifier le niveau d’accès approprié, utiliser Private
, Protected
, Friend
, ou Public
.
Un type Enum
a un nom, un type sous-jacent et un ensemble de champs, chacun représentant une constante. Le nom doit être un qualificateur Visual Basic .NET valide. Le type sous-jacent doit être l’un des types entiers : Byte
, Short
, Long
ou Integer
. Integer
est la valeur par défaut. Les énumérations sont toujours fortement typées et ne sont pas interchangeables avec les types de nombres entiers.
Les énumérations ne peuvent pas avoir de valeurs à virgule flottante. Si une énumération est affectée à une valeur à virgule flottante avec Option Strict On
, une erreur du compilateur se produit. Si Option Strict
est Off
, la valeur est automatiquement convertie en type Enum
.
Pour plus d’informations sur les noms et sur l’utilisation de l’instruction Imports
pour rendre la qualification de nom inutile, consultez Énumérations et qualification de nom.
Déclarer une énumération
Écrivez une déclaration qui inclut un niveau d’accès au code, le mot clé
Enum
et un nom valide, comme dans les exemples suivants, chacun d’entre eux déclare un autreEnum
.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
Définissez les constantes dans l’énumération. Par défaut, la première constante d’une énumération est initialisée
0
et les constantes suivantes sont initialisées sur une valeur d’une autre constante que la constante précédente. Par exemple, l’énumération suivante contientDays
, une constante nomméeSunday
avec la valeur0
, une constante nomméeMonday
avec la valeur1
, une constante nomméeTuesday
avec la valeur de2
, et ainsi de suite.Public Enum Days Sunday Monday Tuesday Wednesday Thursday Friday Saturday End Enum
Vous pouvez attribuer explicitement des valeurs à des constantes dans une énumération à l’aide d’une instruction d’assignation. Vous pouvez attribuer n’importe quelle valeur entière, y compris les nombres négatifs. Par exemple, vous pouvez souhaiter que les constantes avec des valeurs inférieures à zéro représentent des conditions d’erreur. Dans l’énumération suivante, la constante
Invalid
est explicitement affectée à la valeur–1
, et la constanteSunday
est affectée à la valeur0
. Étant donné qu’il s’agit de la première constante de l’énumération,Saturday
est également initialisée à la valeur0
. La valeurMonday
est1
(une valeur supérieure à la valeur deSunday
) ; la valeur deTuesday
est2
, et ainsi de suite.Public Enum WorkDays Saturday Sunday = 0 Monday Tuesday Wednesday Thursday Friday Invalid = -1 End Enum
Déclarer une énumération en tant que type explicite
Spécifiez le type de l’énumération à l’aide de la clause
As
, comme illustré dans l’exemple suivant.Public Enum MyEnum As Byte Zero One Two End Enum
Voir aussi
- Énumérations et qualification de noms
- Comment : faire référence à un membre d'énumération
- Comment : itérer au sein d'une énumération dans Visual Basic
- Comment : déterminer la chaîne associée à une valeur d'énumération
- Quand utiliser une énumération
- Vue d'ensemble des constantes
- Constantes et types de données littérales
- Constantes et énumérations