Partager via

Guide pratique pour 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, , ProtectedFriendou Public.

Un Enum type 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 ,ByteShortLong 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.

Pour déclarer une énumération

  1. Écrivez une déclaration qui inclut un niveau d’accès au code, le Enum mot clé et un nom valide, comme dans les exemples suivants, chacun d’entre eux déclare un autre Enum.

    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. Définissez les constantes dans l’énumération. Par défaut, la première constante d’une énumération est initialisée 0et 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 Days contient une constante nommée Sunday avec la valeur 0, une constante nommée Monday avec la valeur 1, une constante nommée Tuesday avec la valeur 2, et ainsi de suite.

    Public Enum Days
    Sunday
    Monday
    Tuesday
    Wednesday
    Thursday
    Friday
    Saturday
End Enum

  3. Vous pouvez attribuer explicitement des valeurs à des constantes dans une énumération à l’aide d’une instruction d’affectation. Vous pouvez affecter 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 constante Sunday est affectée à la valeur 0. Étant donné qu’il s’agit de la première constante de l’énumération, Saturday elle est également initialisée à la valeur 0. La valeur de Monday est 1 (une de plus que la valeur de Sunday) ; la valeur de Tuesday est 2, et ainsi de suite.

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

Pour déclarer une énumération en tant que type explicite

  • Spécifiez le type de l’énumération à l’aide de la As clause, comme illustré dans l’exemple suivant.

    Public Enum MyEnum As Byte
    Zero
    One
    Two
End Enum

Voir aussi