Freigeben über


Gewusst wie: Deklarieren einer Enumeration (Visual Basic)

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