Partilhar via


Como: Declarar enumerações (Visual Basic)

Você cria uma enumeração com a Enum instrução na seção declarations de uma classe ou módulo. Não é possível declarar uma enumeração dentro de um método. Para especificar o nível apropriado de acesso, use Private, Protected, Friendou Public.

Um Enum tipo tem um nome, um tipo subjacente e um conjunto de campos, cada um representando uma constante. O nome deve ser um qualificador válido do Visual Basic .NET. O tipo subjacente deve ser um dos tipos inteiros—Byte, Short, Long ou Integer. Integer é a predefinição. As enumerações são sempre fortemente tipadas e não são intercambiáveis com tipos de números inteiros.

As enumerações não podem ter valores de vírgula flutuante. Se for atribuído a uma enumeração um valor de ponto flutuante com Option Strict On, um erro do compilador resultará. Se Option Strict for Off, o valor é convertido automaticamente para o Enum tipo.

Para obter informações sobre nomes e como usar a instrução para tornar a Imports qualificação de nome desnecessária, consulte Enumerações e qualificação de nome.

Para declarar uma enumeração

  1. Escreva uma declaração que inclua um nível de acesso ao código, a Enum palavra-chave e um nome válido, como nos exemplos a seguir, cada um dos quais declara um 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. Defina as constantes na enumeração. Por padrão, a primeira constante em uma enumeração é inicializada para 0, e as constantes subsequentes são inicializadas com um valor de um a mais do que a constante anterior. Por exemplo, a enumeração a seguir, Days, contém uma constante nomeada Sunday com o valor 0, uma constante nomeada Monday com o valor 1, uma constante nomeada Tuesday com o valor de 2, e assim por diante.

    Public Enum Days
        Sunday
        Monday
        Tuesday
        Wednesday
        Thursday
        Friday
        Saturday
    End Enum
    
  3. Você pode atribuir explicitamente valores a constantes em uma enumeração usando uma instrução de atribuição. Você pode atribuir qualquer valor inteiro, incluindo números negativos. Por exemplo, você pode querer constantes com valores menores que zero para representar condições de erro. Na enumeração a seguir, a constante Invalid é explicitamente atribuída o valor –1, e a constante Sunday é atribuída o valor 0. Por ser a primeira constante na enumeração, Saturday também é inicializada com o valor 0. O valor de Monday is 1 (um a mais que o valor de Sunday); o valor de Tuesday is 2, e assim por diante.

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

Para declarar uma enumeração como um tipo explícito

  • Especifique o tipo de enum usando a As cláusula, conforme mostrado no exemplo a seguir.

    Public Enum MyEnum As Byte
        Zero
        One
        Two
    End Enum
    

Consulte também