Freigeben über


Gewusst wie: Deklarieren einer Enumeration (Visual Basic)

Sie können eine Enumeration mithilfe der Enum-Anweisung im Deklarationsabschnitt einer Klasse oder eines Moduls erstellen. Es ist nicht möglich, eine Enumeration innerhalb einer Methode zu deklarieren. Zur Angabe der geeigneten Zugriffsebene verwenden Sie Private, Protected, Friend oder Public.

Ein Enum-Typ hat einen Namen, einen zugrunde liegenden Typ und eine Reihe von Feldern, die jeweils eine Konstante darstellen. Der Name muss ein gültiger Visual Basic 2005-Qualifizierer sein. Bei dem zugrunde liegenden Typ muss es sich um einen ganzzahligen Typ handeln, d. h. Byte, Short, Long oder Integer. Standardmäßig ist Integer festgelegt. Enumerationen sind immer stark typisiert und nicht mit Ganzzahltypen austauschbar.

Enumerationen dürfen keine Gleitkommawerte haben. Wenn Option Strict On aktiviert ist und einer Enumeration ein Gleitkommawert zugewiesen wird, führt dies zu einem Compilerfehler. Wenn für Option Strict die Einstellung Off gewählt ist, wird der Wert automatisch in den Enum-Typ konvertiert.

Weitere Informationen zu Namen und zur Verwendung der Imports-Anweisung zur Umgehung der Qualifizierung von Namen finden Sie unter Enumerationen und Namensqualifikation (Visual Basic).

So deklarieren Sie eine Enumeration

  1. Erstellen Sie eine Deklaration, die eine Codezugriffsebene, das Schlüsselwort Enum und einen gültigen Namen umfasst, wie in den folgenden Beispielen gezeigt, in denen mit Enum jeweils verschiedene Enumerationen deklariert werden.

    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. Definieren Sie die Konstanten der Enumeration. Die erste Konstante einer Enumeration wird standardmäßig mit 0 initialisiert, für alle nachfolgenden Konstanten wird der Initialisierungswert jeweils um 1 erhöht. Die folgende Enumeration (Days) enthält beispielsweise eine Konstante mit dem Namen Sunday mit dem Wert 0, eine Konstante mit dem Namen Monday mit dem Wert 1, eine Konstante mit dem Namen Tuesday mit dem Wert 2 usw.

    Public Enum Days
      Sunday
      Monday
      Tuesday
      Wednesday
      Thursday
      Friday
      Saturday
    End Enum
    
  3. Sie können Konstanten in einer Enumeration explizit Werte zuweisen, indem Sie eine Zuweisungsanweisung verwenden. Es kann ein beliebiger ganzzahliger Wert (auch negative Zahlen) zugewiesen werden. Konstanten mit Werten unter 0 können beispielsweise zur Darstellung von Fehlerbedingungen verwendet werden. In der folgenden Enumeration wird der Konstanten Invalid explizit der Wert –1 zugewiesen, und der Konstanten Sunday wird der Wert 0 zugewiesen. Weil es sich um die erste Konstante der Enumeration handelt, wird Saturday zudem mit dem Wert 0 initialisiert. Die Konstante Monday hat den Wert 1 (der um eins höher ist als der Wert von Sunday); die Konstante Tuesday hat den Wert 2 usw.

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

Dieses Codebeispiel ist auch als IntelliSense-Codeausschnitt verfügbar. Sie finden es in der Codeausschnittauswahl unter Programmiersprache Visual Basic. Weitere Informationen finden Sie unter Gewusst wie: Einfügen von IntelliSense-Codeausschnitten.

So deklarieren Sie eine Enumeration als expliziten Typ

  • Geben Sie den Typ der Enumeration mit der As-Klausel an, wie im folgenden Beispiel gezeigt.

    Public Enum MyEnum As Byte
      Zero
      One
      Two
    End Enum
    

Siehe auch

Aufgaben

Gewusst wie: Verweisen auf einen Enumerationsmember (Visual Basic)

Gewusst wie: Durchlaufen einer Enumeration in Visual Basic

Gewusst wie: Bestimmen der einem Enumerationswert zugeordneten Zeichenfolge (Visual Basic)

Konzepte

Enumerationen und Namensqualifikation (Visual Basic)

Situationen für die Verwendung von Enumerationen (Visual Basic)

Übersicht über Konstanten (Visual Basic)

Konstanten und literale Datentypen (Visual Basic)

Konstanten und Enumerationen (Visual Basic)