Gewusst wie: Deklarieren von Enumerationen

Artikel
09/03/2008

Aktualisiert: November 2007

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 wird Integer verwendet. 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.

So deklarieren Sie eine Enumeration

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

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
```
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 das Element in der Codeausschnittauswahl unter Programmiersprache Visual Basic. Weitere Informationen finden Sie unter Gewusst wie: Einfügen von Ausschnitten in den Code (Visual Basic).

So deklarieren Sie eine Enumeration explizit

Schreiben Sie eine Deklaration unter Verwendung der folgenden Syntax:
```
Public Enum MyEnum As Byte
  Zero
  One
  Two
End Enum
```

Siehe auch

Freigeben über

Gewusst wie: Deklarieren von Enumerationen

So deklarieren Sie eine Enumeration

So deklarieren Sie eine Enumeration explizit

Siehe auch

Aufgaben

Konzepte

Weitere Ressourcen

Zusätzliche Ressourcen