Freigeben über


Vorgehensweise: Deklarieren von Enumerationen (Visual Basic)

Sie erstellen eine Aufzählung mit der Enum Anweisung im Deklarationsbereich einer Klasse oder eines Moduls. Sie können eine Aufzählung innerhalb einer Methode nicht deklarieren. Um die entsprechende Zugriffsebene anzugeben, 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 .NET-Qualifizierer sein. Der zugrunde liegende Typ muss eines der ganzzahligen Typen sein –ByteShortLong oder Integer. Integer ist die Standardeinstellung. Enumerationen sind immer stark typisiert und nicht mit Integertypen austauschbar.

Enumerationen können keine Gleitkommawerte aufweisen. Wenn einer Aufzählung mit Option Strict On ein Gleitkommawert zugewiesen wird, führt dies zu einem Compilerfehler. Wenn Option Strict ist Off, wird der Wert automatisch in den Enum Typ konvertiert.

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

Deklarieren einer Enumeration

  1. Schreiben Sie eine Deklaration, die eine Codezugriffsebene, das Enum Schlüsselwort und einen gültigen Namen enthält, wie in den folgenden Beispielen, die jeweils eine andere Enumdeklariert.

    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 Aufzählung auf 0 initialisiert, und nachfolgende Konstanten werden auf einen um eins höheren Wert als die vorherige Konstante initialisiert. Die folgende Aufzählung, Days, enthält beispielsweise eine Konstante namens Sunday mit dem Wert 0, eine Konstante namens Monday mit dem Wert 1, eine Konstante namens Tuesday mit dem Wert 2, und so weiter.

    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 Zuordnungsanweisung verwenden. Sie können einen beliebigen ganzzahligen Wert einschließlich negativer Zahlen zuweisen. So möchten Sie beispielsweise Konstanten mit Werten kleiner als 0, um Fehlerbedingungen darzustellen. In der folgenden Aufzählung wird die Konstante Invalid explizit dem Wert –1zugewiesen, und der Konstante Sunday wird der Wert 0zugewiesen. Da es sich um die erste Konstante in der Enumeration handelt, Saturday wird sie auch für den Wert 0initialisiert. Der Wert von Monday ist 1 (eins mehr als der Wert von Sunday); der Wert des Werts Tuesday ist 2usw.

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

So deklarieren Sie eine Aufzählung als expliziten Typ

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

    Public Enum MyEnum As Byte
        Zero
        One
        Two
    End Enum
    

Siehe auch