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
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 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)