Como: Declarar enumerações

Você cria uma enumeração com o Enum demonstrativo 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.

An Enum tipo tem um nome, um tipo subjacente e um conjunto de campos, cada uma representando uma constante. O nome deve ser um 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 rigidez de tipos 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 erro ao compilador os resultados. If Option Strict é Off, o valor é convertido automaticamente para o Enum Digite.

Para obter informações sobre nomes e como usar o Imports demonstrativo tornam desnecessário o nome de qualificação, consulte Enumerações e Qualificações de Nome.

Para declarar uma enumeração

  1. gravar uma declaração que inclui um nível de acesso do código, a Enum palavra-chave e um nome válido, sistema autônomo nos exemplos a seguintes, cada um deles 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 uma enumeração é inicializado 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 2, e assim por diante.

    Public Enum Days
      Sunday
      Monday
      Tuesday
      Wednesday
      Thursday
      Friday
      Saturday
    End Enum
    
  3. Você pode atribuir explicitamente valores para constantes em uma enumeração usando uma demonstrativo 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.In the following enumeration, the constant Invalid is explicitly assigned the value –1, and the constant Sunday is assigned the value 0.Porque é a primeira constante na enumeração, Saturday também é inicializada para o valor 0. O valor de Monday é 1 (um 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
    

Este exemplo de código também está disponível como um trecho de código IntelliSense.No selecionador de trechos de código, ele está localizado em Visual Basic Language.Para obter mais informações, consulte Como: Inserir trechos em seu Código (Visual Basic).

Para declarar explicitamente uma enumeração

  • Escreva uma declaração usando a sintaxe a seguir.

    Public Enum MyEnum As Byte
      Zero
      One
      Two
    End Enum
    

Consulte também

Tarefas

Como: Consulte um membro de enumeração

Como: Iterar por uma enumeração no Visual Basic

Como: Determinar o valor de string associado com um valor de enumeração

Conceitos

Enumerações e Qualificações de Nome

Quando usar uma enumeração

Constantes Intrínsecas e Enumerações

Tipos de Dado Constante e Literal

Outros recursos

Constantes no Visual Basic