Cómo: Declarar enumeraciones (Visual Basic)

  • Artículo

Cree una enumeración con la instrucción Enum en la sección de declaraciones de una clase o módulo. No se puede declarar una enumeración dentro de un método. Para especificar el nivel de acceso adecuado, use 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 .NET válido. El tipo subyacente debe ser uno de los tipos enteros: Byte, Short, Long o Integer. Integer es el valor predeterminado. Las enumeraciones siempre están fuertemente tipadas y no son intercambiables con tipos de números enteros.

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

Para más información sobre los nombres y cómo usar la instrucción Imports para hacer que la calificación de nombres no sea necesaria, consulte Enumeraciones y calificación de nombres.

Para declarar una enumeración

  1. Escriba una declaración que incluya un nivel de acceso de código, la palabra clave Enum y un nombre válido, como en los ejemplos siguientes, cada uno de los cuales declara un valor 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 de la enumeración. De forma predeterminada, la primera constante de una enumeración se inicializa en 0 y las constantes posteriores se inicializan en un valor de uno más que el de la constante anterior. Por ejemplo, la enumeración siguiente, 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. Puede asignar explícitamente valores a constantes de una enumeración mediante una instrucción de asignación. Puede asignar cualquier valor entero, incluidos números negativos. Por ejemplo, puede que desee constantes con valores inferiores a cero para representar condiciones de error. En la enumeración siguiente, a la constante Invalid se le asigna explícitamente el valor –1, y a la constante Sunday se le asigna el valor 0. Dado que es la primera constante de la enumeración, Saturday también se inicializa en el valor 0. El valor de Monday es 1 (uno más que el valor de Sunday); el valor de Tuesday es 2, etc.

    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 la enumeración mediante la cláusula As, como se muestra en el ejemplo siguiente.

    Public Enum MyEnum As Byte
    Zero
    One
    Two
End Enum

Consulte también