Compartir a través de


Cómo: Declarar enumeraciones (Visual Basic)

Una enumeración se crea con la instrucción Enum en la sección de declaraciones de una clase o módulo. No puede declarar una enumeración dentro de un método. Para especificar el nivel adecuado de acceso, utilice Private, Protected, Friend o Public.

Un tipo Enum tiene un nombre, un tipo subyacente y un conjunto de campos, cada uno de los cuales representa una constante. El nombre debe ser un calificador de Visual Basic 2005 válido. El tipo subyacente debe ser uno de los tipos de enteros Byte, Short, Long o Integer. Integer es el valor predeterminado. Las enumeraciones están siempre fuertemente tipadas y no son intercambiables con los tipos de números enteros.

Las enumeraciones no pueden tener valores de punto flotante. Si se asigna un valor de punto flotante a una enumeración con Option Strict On, se producirá un error del compilador. Si Option Strict es Off, el valor se convierte automáticamente en el tipo Enum.

Para obtener información sobre los nombres y sobre cómo utilizar la instrucción Imports de manera que la calificación de nombres resulte innecesaria, consulte Enumeraciones y calificación de nombres (Visual Basic).

Para declarar una enumeración

  1. Escriba una declaración que incluya un nivel de acceso al código, la palabra clave Enum y un nombre válido, como en los ejemplos siguientes, cada uno de los cuales declara una palabra clave Enum diferente.

    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 las constantes en la enumeración. De manera predeterminada, la primera constante de una enumeración se inicializa con 0 y las siguientes se inicializan con un valor igual al de la constante anterior más uno. Por ejemplo, la siguiente enumeración, Days, contiene una constante denominada Sunday con el valor 0, una constante denominada Monday con el valor 1, una constante denominada Tuesday con el valor 2, etc.

    Public Enum Days
      Sunday
      Monday
      Tuesday
      Wednesday
      Thursday
      Friday
      Saturday
    End Enum
    
  3. Se pueden asignar explícitamente valores a constantes en una enumeración mediante una instrucción de asignación. Se puede asignar cualquier valor entero, incluidos números negativos. Por ejemplo, puede que desee que las constantes con valores menores que cero representen condiciones de error. En la siguiente enumeración, a la constante Invalid se le asigna explícitamente el valor –1, y a la constante Sunday se le asigna el valor 0. Como es la primera constante de la enumeración, Saturday también se inicializa con el valor 0. El valor de Monday es 1 (el valor de Sunday más uno); el valor de Tuesday es 2, y así sucesivamente.

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

Para declarar una enumeración como un tipo explícito

  • Especifique el tipo de enumeración mediante la cláusula As, tal y como se muestra en el siguiente ejemplo.

    Public Enum MyEnum As Byte
      Zero
      One
      Two
    End Enum
    

Vea también

Tareas

Cómo: Hacer referencia al miembro de una enumeración (Visual Basic)

Cómo: Recorrer en iteración una enumeración en Visual Basic

Cómo: Determinar la cadena asociada a un valor de enumeración (Visual Basic)

Conceptos

Enumeraciones y calificación de nombres (Visual Basic)

Cuándo se debe usar una enumeración (Visual Basic)

Información general sobre las constantes (Visual Basic)

Tipos de datos constantes y literales (Visual Basic)

Constantes y enumeraciones (Visual Basic)