Compartilhar via


Como: Declarar enumerações (Visual Basic)

criar uma enumeração com o Enumdedemonstrativo 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 inteiro —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 flutuante-valores de ponto. Se uma enumeração é atribuído um valor de ponto flutuante de-com Option Strict On, um resultados de erro 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 Importsdedemonstrativo para fazer a qualificação de nome desnecessária, 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 acessodo código, o Enumapalavra-chavee um nome válido , como nos exemplos a seguir, cada qual 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. Define the constants in the enumeration. Por padrão, a primeira constante em uma enumeração é inicializada para 0, e constantes subseqüentes são inicializados com um valor de um mais constante anterior. Por exemplo, a seguinte enumeração, 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 de 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 utilizando 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 seguinte enumeração, a constante Invalid explicitamente é atribuído o valor –1e a constante Sunday é atribuído 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
    

This code example is also available as an IntelliSense code snippet. In the code snippet picker, it is located in Visual Basic Language. For more information, see Como: Inserir trechos de código de IntelliSense.

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

  • Especifique o tipo de 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: Fazer referência a um membro de enumeração (Visual Basic)

Como: Fazer iterações por uma enumeração no Visual Basic

Como: determinar a sequência de caracteres associada com 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 sobre constantes (Visual Basic)

Tipos de dados Constante e Literal (Visual Basic)

Constantes e Enumerações (Visual Basic)