Como declarar enumerações (Visual Basic)

Crie uma enumeração com a instrução Enum na seção declarações de uma classe ou módulo. Você não pode declarar uma enumeração dentro de um método. Para especificar o nível apropriado de acesso, usePrivate, Protectedou FriendPublic.

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—ByteShortLong ou .Integer Integer é o padrão. As enumerações são sempre fortemente tipadas e não são intercambiáveis com tipos de número inteiro.

Enumerações não podem ter valores de ponto flutuante. Se uma enumeração receber um valor de ponto flutuante com Option Strict On, um erro do compilador resultará. Se Option Strict for Off, o valor será convertido automaticamente para o tipo Enum.

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

Para declarar uma enumeração

1. Escreva uma declaração que inclua um nível de acesso de código, a Enum palavra-chave e um nome válido, como nos exemplos a seguir, cada um dos quais declara um diferente 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 0e as constantes subsequentes são inicializadas para 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 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, talvez você queira que constantes com valores inferiores a zero representem condições de erro. Na enumeração a seguir, a constante Invalid recebe explicitamente o valor –1e a constante Sunday recebe o valor 0. Como é a primeira constante na enumeração, Saturday também é inicializada para o valor 0. Monday é 1 (um a mais do que o valor de Sunday); o valor de Tuesday é 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 da enumeração usando a As cláusula, conforme mostrado no exemplo a seguir.

  Public Enum MyEnum As Byte
      Zero
      One
      Two
  End Enum
  

Consulte também

• Enumerações e qualificação de nome
• Como fazer referência a um membro de enumeração
• Como iterar em uma enumeração no Visual Basic
• Como determinar a cadeia de caracteres associada a um valor de enumeração
• Quando usar uma enumeração
• Visão geral das constantes
• Tipos de dados constantes e literais
• constantes e enumerações