Partager via


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

  1. É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 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 contient Days, 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 de 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’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 constante Sunday est affectée à la valeur 0. Étant donné qu’il s’agit de la première constante de l’énumération, Saturday est également initialisée à la valeur 0. La valeur Monday est 1 (une valeur supérieure à 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
    

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