Gewusst wie: Deklarieren einer Enumeration (Visual Basic)

  • Artikel

Sie erstellen eine Enumeration mit der Enum-Anweisung im Deklarationsbereich einer Klasse oder eines Moduls. Sie können eine Enumeration nicht in einer Methode deklarieren. Um die entsprechende Zugriffsebene anzugeben, verwenden Sie Private, Protected, Friend oder Public.

Ein Enum-Typ hat einen Namen, einen zugrunde liegenden Typ und einen Satz Felder, die jeweils eine Konstante repräsentieren. Der Name muss ein gültiger Visual Basic .NET-Qualifizierer sein. Der zugrunde liegende Typ muss einer der Integertypen sein: Byte, Short, Long oder Integer. Integer ist die Standardoption. Enumerationen sind immer stark typisiert und nicht mit Integertypen austauschbar.

Enumerationen können keine Gleitkommawerte aufweisen. Die Zuweisung eines Gleitkommawert mit Option Strict On zu einer Enumeration führt zu einem Compilerfehler. Wenn Option Strict als Off festgelegt ist, wird der Wert automatisch in den Enum-Typ konvertiert.

Informationen zu Namen und zur Verwendung der Imports-Anweisung, um die Qualifizierung von Namen unnötig zu machen, finden Sie unter Enumerationen und Namensqualifikation.

Deklarieren einer Enumeration

  1. Schreiben Sie eine Deklaration, die eine Codezugriffsebene, das Schlüsselwort Enum und einen gültigen Namen enthält, wie in den folgenden Beispielen gezeigt, die jeweils ein anderes Enum-Element deklarieren.

    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 in der Enumeration. Standardmäßig wird die erste Konstante in einer Enumeration als 0 initialisiert, und nachfolgende Konstanten werden als Wert initialisiert, der um eins höher ist als der der vorherigen Konstante. Beispielsweise enthält die folgende Enumeration Days eine Konstante namens Sunday mit dem Wert 0, eine Konstante namens Monday mit dem Wert 1, eine Konstante namens 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. Sie können einen beliebigen Integerwert einschließlich negativer Zahlen zuweisen. Ein Beispiel: Sie möchten Konstanten mit Werten kleiner als 0 haben, um Fehlerbedingungen zu repräsentieren. In der folgenden Enumeration wird der Konstante Invalid explizit der Wert –1 zugewiesen, und der Konstante Sunday wird der Wert 0 zugewiesen. Da es sich um die erste Konstante in der Enumeration handelt, wird Saturday auch als Wert 0 initialisiert. Der Wert von Monday ist 1 (um eins höher als der Wert von Sunday); der Wert von Tuesday ist 2 usw.

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

Deklarieren einer Enumeration als expliziten Typ

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

    Public Enum MyEnum As Byte
    Zero
    One
    Two
End Enum

Siehe auch