Compartilhar via


Como: declarar enumerações (Visual Basic)

Você cria uma enumeração com o Enum a instrução 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, use Private, Protected, Friend, ou Public.

Um Enum o tipo tem um nome, um tipo subjacente e um conjunto de campos, cada uma representando uma constante.O nome deve ser válido Visual Basic 2005 qualificador.O tipo subjacente deve ser um dos tipos inteiros —Byte, Short, Long ou Integer.Integeré o padrão.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 é atribuída um valor de ponto flutuante com Option Strict On, um resulta de erros do compilador.Se Option Strict é Off, o valor será automaticamente convertido para o Enum tipo.

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

Para declarar uma enumeração

  1. Escrever uma declaração que inclui um nível de acesso a código, o Enum palavra-chave e um nome válido, como nos exemplos a seguir, cada um deles declara uma 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 para 0, e constantes subseqüentes são inicializados para um valor de um mais do que a constante anterior.Por exemplo, a enumeração seguinte, Days, contém uma constante chamada Sunday com o valor 0, uma constante chamada Monday com o valor 1, uma constante chamada Tuesday com o valor da 2e assim por diante.

    Public Enum Days
      Sunday
      Monday
      Tuesday
      Wednesday
      Thursday
      Friday
      Saturday
    End Enum
    
  3. Você pode atribuir explicitamente valores constantes em uma enumeração usando uma instrução de atribuição.Você pode atribuir qualquer valor inteiro, incluindo os números negativos.Por exemplo, convém constantes com valores menores que zero para representar as condições de erro.Na enumeração seguinte, a constante Invalid explicitamente é atribuído o valor –1e a constante Sunday recebe o valor 0.Porque é a primeira constante na enumeração, Saturday também é inicializada com o valor 0.O valor de Monday é 1 (mais do que o valor de um Sunday); o valor de Tuesday é 2e 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

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

    Public Enum MyEnum As Byte
      Zero
      One
      Two
    End Enum
    

Consulte também

Tarefas

Como: se referir a um membro de enumeração (Visual Basic)

Como: iterar por meio de uma enumeração de Visual Basic

Como: determinar a seqüência associada a um valor de enumeração (Visual Basic)

Conceitos

Enumerações e qualificação de nome (Visual Basic)

Quando usar uma enumeração (Visual Basic)

Visão geral de constantes (Visual Basic)

Constante e tipos de dados literais (Visual Basic)

Constantes e enumerações (Visual Basic)