Cómo: Declarar enumeraciones
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
Tareas
Cómo: Hacer referencia al miembro de una enumeración
Cómo: Recorrer en iteración una enumeración en Visual Basic
Cómo: Determinar la cadena asociada a un valor de enumeración
Conceptos
Enumeraciones y calificación de nombres
Cuándo se debe utilizar una enumeración
Constantes y enumeraciones intrínsecas
Tipos de datos constantes y literales