Cómo: Declarar enumeraciones

Artículo
10/07/2008

Actualización: noviembre 2007

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 tienen siempre establecimiento inflexible de tipos 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.

Para declarar una enumeración

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

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
```
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
```

Este ejemplo de código también está disponible en el fragmento de código de IntelliSense. En el selector de fragmentos de código, se encuentra en Lenguaje Visual Basic. Para obtener más información, consulte Cómo: Insertar fragmentos de código en el código (Visual Basic).

Para declarar una enumeración explícitamente

Escriba una declaración con la sintaxis siguiente.

Public Enum MyEnum As Byte
  Zero
  One
  Two
End Enum

Vea también

Compartir a través de

Cómo: Declarar enumeraciones

Para declarar una enumeración

Para declarar una enumeración explícitamente

Vea también

Tareas

Conceptos

Otros recursos

Recursos adicionales