Sdílet prostřednictvím

Postupy: Deklarace výčtů (Visual Basic)

Vytvoříte výčet s příkazem Enum v části deklarací třídy nebo modulu. Nelze deklarovat výčet v rámci metody. Chcete-li určit odpovídající úroveň přístupu, použijte Private, Protected, Friend, nebo Public.

Typ Enum má název, podkladový typ a sadu polí, z nichž každý představuje konstantu. Název musí být platný kvalifikátor .NET jazyka Visual Basic. Základní typ musí být jedním z celočíselného typu ,ByteShortLong nebo Integer. Integer je výchozí. Výčty jsou vždy silného typu a nejsou zaměnitelné s celočíselnými typy.

Výčty nemohou mít hodnoty s plovoucí čárkou. Pokud je výčtu přiřazeno desetinné číslo s použitím Option Strict On, dojde k chybě kompilátoru. Pokud Option Strict je Off, hodnota se automaticky převede na typ Enum.

Informace o názvech a o tom, jak použít Imports příkaz, aby nebylo potřeba kvalifikovat názvy, najdete v tématu Výčty a kvalifikace názvů.

Jak deklarovat výčet

  1. Napište deklaraci, která obsahuje úroveň přístupu kódu, Enum klíčové slovo a platný název, jako v následujících příkladech, z nichž každá deklaruje jinou 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. Definujte konstanty v výčtu. Ve výchozím nastavení je první konstanta ve výčtu inicializována na 0a následné konstanty jsou inicializovány na hodnotu jedné více než předchozí konstanty. Například následující výčet Days obsahuje konstantu s názvem Sunday s hodnotou 0, konstantu s názvem Monday s hodnotou 1, konstantu s názvem Tuesday s hodnotou 2 a tak dále.

    Public Enum Days
    Sunday
    Monday
    Tuesday
    Wednesday
    Thursday
    Friday
    Saturday
End Enum

  3. Hodnoty můžete explicitně přiřadit konstantám v výčtu pomocí příkazu přiřazení. Můžete přiřadit libovolnou celočíselnou hodnotu včetně záporných čísel. Můžete například chtít, aby konstanty s hodnotami menšími než nulou představovaly chybové podmínky. V následujícím výčtu je konstanta Invalid explicitně přiřazena hodnotu –1a konstanta Sunday je přiřazena hodnotu 0. Protože je to první konstanta v výčtu, Saturday je také inicializována na hodnotu 0. Hodnota Monday je 1 (jedna více než hodnota Sunday); hodnota Tuesday je 2atd.

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

Chcete-li deklarovat výčet jako explicitní typ

  • Určete typ výčtu pomocí konstrukce As, jak je uvedeno v následujícím příkladu.

    Public Enum MyEnum As Byte
    Zero
    One
    Two
End Enum

Viz také