Udostępnij za pomocą


Jak: Deklarowanie wyliczeń (Visual Basic)

Utworzysz wyliczenie z instrukcją Enum w sekcji deklaracji klasy lub modułu. Nie można zadeklarować wyliczenia w ramach metody. Aby określić odpowiedni poziom dostępu, użyj polecenia Private, Protected, Friendlub Public.

Typ Enum ma nazwę, typ bazowy i zestaw pól, z których każdy reprezentuje stałą. Nazwa musi być prawidłowym kwalifikatorem Visual Basic .NET. Typ bazowy musi być jednym z typów całkowitych —Byte , ShortLong lub Integer. Integer jest wartością domyślną. Wyliczenia są zawsze silnie typizowane i nie są wymienne z typami liczb całkowitych.

Wyliczenia nie mogą mieć wartości zmiennoprzecinkowych. Jeśli wyliczeniu przypisana jest wartość zmiennoprzecinkowa z Option Strict On, skutkuje to błędem kompilatora. Jeśli Option Strict jest Off, wartość jest automatycznie konwertowana na typ Enum.

Aby uzyskać informacje o nazwach oraz o tym, jak używać instrukcji Imports, aby zrezygnować z konieczności kwalifikowania nazw, zobacz Wyliczenia i Kwalifikacje nazw.

Aby zadeklarować wyliczenie

  1. Napisz deklarację zawierającą poziom dostępu kodu, Enum słowo kluczowe i prawidłową nazwę, jak w poniższych przykładach, z których każdy deklaruje inny element 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. Zdefiniuj stałe w wyliczeniu. Domyślnie pierwsza stała w wyliczeniu jest inicjowana z wartością 0, a kolejne stałe są inicjowane z wartością o jeden większą niż poprzednia stała. Na przykład następujące wyliczenie, Days, zawiera stałą o nazwie Sunday o wartości 0, stałą o nazwie Monday o wartości 1, stałą o nazwie Tuesday o wartości 2, i tak dalej.

    Public Enum Days
        Sunday
        Monday
        Tuesday
        Wednesday
        Thursday
        Friday
        Saturday
    End Enum
    
  3. Możesz jawnie przydzielić wartości do stałych w wyliczeniu przy użyciu instrukcji przypisania. Można przypisać dowolną wartość całkowitą, w tym liczby ujemne. Na przykład możesz chcieć, aby stałe z wartościami mniejszymi niż zero odzwierciedlały warunki błędu. W poniższym wyliczeniu stała Invalid jest jawnie przypisana do wartości –1, a stała Sunday jest przypisana do wartości 0. Ponieważ jest to pierwsza stała w wyliczeniu, Saturday jest również inicjowany do wartości 0. Wartość Monday to 1 (jedną więcej niż wartość Sunday); wartość Tuesday to 2, itd.

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

Aby zadeklarować wyliczenie jako jawny typ

  • Określ typ wyliczenia przy użyciu klauzuli As, jak pokazano w poniższym przykładzie.

    Public Enum MyEnum As Byte
        Zero
        One
        Two
    End Enum
    

Zobacz także