Anzeige
Anzeige
Anzeige
Anzeige
Anzeige
Anzeige
Lesedauer 6 Min.

Enums mit Komfortfunktion

Enums sind in Zeiten von unbegrenztem Speicher und außerhalb des AI-Bereichs so gut wie kostenloser Rechenleistung in den Hintergrund getreten. Mit dem NuGet-Paket Enums.NET steht eine Bibliothek zur Verfügung, die dem vernachlässigten Sprachfeature verschiedenste Komfortfunktionen verleiht.
Enums.jpg
© Gemini

Enums sind im Grunde genommen ein Weg zur Zusammenfassung von Flags, die fortan unter einem bequemeren Namen ansprechbar sind. Als Beispiel würde das folgende Snippet eine Enum generieren, die die Arbeitstage der Woche exponiert:

 

enum Wochentag
{
    Montag,
    Dienstag,
    Mittwoch,
    Donnerstag,
    Freitag
}

 

Die Konversion in eine ausgebbare Zahl erfolgt dann nach folgendem Schema – für alles andere ist entweder Glue-Code oder aber die Einbindung von Enums.NET erforderlich:

 

int tagNummer = (int)heute;
Console.WriteLine($"Index von {heute} ist: {tagNummer}");

 

Außerdem gilt, dass vergleichsweise viele Operationen gegen Enums intern auf Reflection setzen – ein Aspekt, der wie in Bild 1 gezeigt der Performance eher nicht förderlich ist.

Die Enums.NET-Bibliothek beschleunigt Enum-bezogene Operationen immens (Bild 1)

Die Enums.NET-Bibliothek beschleunigt Enum-bezogene Operationen immens (Bild 1)

© Tyler Brinkley

Willkommen in der Welt von Enums.NET

Aus technischer Sicht ist die Bibliothek nicht sonderlich anspruchsvoll: Die Version 4.x funktioniert mit so gut wie jeder Version des .NET-Frameworks, während Version 5.x auf .NET 4.5 und Standard 1.0 verzichtet.

Für maximale Bequemlichkeit beginnen wir unsere Experimente mit einem Kommandozeilenprojekt, das auf .NET 8.0 basiert und keine Anweisungen der obersten Ebene verwendet. Bei der Suche in NuGet ist der String Enums.NET zu verwenden. Enums.net führt nicht zum Auffinden der von Tyler Brinkley angebotenen Bibliothek.

Im nächsten Schritt wollen wir eine nach folgendem Schema aufgebaute Enum erzeugen, die den Wochentagen über ein hauseigenes, aber auf normalem C# basierendes Attribut Symbole einschreibt:

 

using EnumsNET;
internal class Program {
    enum Wochentag
    {
        [Symbol("A")]
        Montag,
        [Symbol("B")]
        Dienstag,
        [Symbol("C")]
        Mittwoch,
        [Symbol("D")]
        Donnerstag,
        [Symbol("E")]   
        Freitag,
        [Symbol("F"), PrimaryEnumMember]
        Fauchtag = Freitag
   }

 

Zu beachten ist, dass wir hier mit Fauchtag und Freitag zwei im Prinzip identische Attribute haben, denen aber zwei unterschiedliche Symbole zugewiesen wurden. Wichtigste und von Enums.NET eingetragene Änderung ist dabei das Attribut PrimaryEnumMember, das einfach hinter dem Tag-Symbol platziert wird.

Im Interesse der Vollständigkeit hier noch ein kurzer Blick auf die Deklaration des Attributs, das für die Vorhaltung des Symbols zuständig ist:

 

[AttributeUsage(AttributeTargets.Field)]
    class SymbolAttribute : Attribute {
        public string Symbol { get; }
    public SymbolAttribute(string symbol) {
        Symbol = symbol;
    }
}

 

Im nächsten Schritt können wir damit beginnen, die in den Enum-Feldern abgelegten Symbol-Attribute auszulesen:

 

static void Main(string[] args) {
    Console.WriteLine(Wochentag.Fauchtag.GetAttributes().Get<SymbolAttribute>().Symbol);
}

 

In normalem C# gilt bei der Verarbeitung von Enums das Prinzip: „Wer zuerst kommt, mahlt zuerst.“ Da wir hier allerdings über PrimaryEnumMember festlegen, welches Mitglied der Enum Priorität genießt, sieht die Ausgabe folgendermaßen aus:

 

F
C:\Users\tamha\source\repos\EnumNetDemo1\EnumNetDemo1\bin\Debug\net8.0\EnumNetDemo1.exe (Prozess "8912") wurde mit Code "0" (0x0) beendet.

Effizienzsteigerung bei der Stringifizierung von Enums

Die Konversion von Enum-Werten in ihre im Code vergebenen Namen ist per se Teil des C#-Sprachstandards. In Enums.NET steht als Alternative zur bekannten ToString-Methode die Methode AsString Verfügung. Zum Vergleich wollen wir die beiden Varianten nach folgendem Schema auf unsere Test-Enum anwenden:

 

static void Main(string[] args) {
    Console.WriteLine(Wochentag.Fauchtag.ToString());
    Console.WriteLine(Wochentag.Fauchtag.AsString());
}

 

Der erste – und hier nicht wirklich sichtbare – Vorteil der neuen Methode ist, dass sie ihre nützliche Aufgabe ohne Zugriff auf das Reflection-System des Frameworks bewerkstelligt.

In der Praxis bedeutet dies, dass nach dem ersten Aufruf ein Cache zur Verfügung steht, der mehrmalige Enum-zu-String-Konversionen massiv zu beschleunigen vermag.

Zweitens ist die neue Variante zur Auswertung des PrimaryEnumMember-Attributs befähigt. Dies zeigt sich daran, dass die beiden Tage nach folgendem Schema in der Ausgabe unterschiedlicher Strings konvertiert werden:

 

Freitag
Fauchtag
C:\Users\tamha\source\repos\EnumNetDemo1\EnumNetDemo1\bin\Debug\net8.0\EnumNetDemo1.exe (Prozess "14392") wurde mit Code "0" (0x0) beendet.

Management von Bitflags

Während gewöhnliche Enums meist mehr oder weniger beliebige numerische Werte freundlicher ansprechbar machen, ist das Bitflag eine besondere Variante. Sie zeichnet sich dadurch aus, dass jeder Zustand normalerweise nur mit 1 Bit korrespondiert. Dies ist zum Beispiel dann nützlich, wenn gezielt einzelne Bits in einem Register angesprochen werden müssen.

Bild 2 stammt aus dem Datenblatt des weitverbreiteten PIC16F84A-Mikrocontrollers und zeigt das Layout eines seiner GPIO-Register. Offensichtlich ist, dass jedes Bit mit einem der GPIO-Transceiver verbunden ist.

Sofern der Transceiver im Schreibmodus ist, werden die vom Benutzerprogramm in den Bits abgelegten Werte ausgegeben. Beim Lesen finden sich in den Bits die Spannungspegel-Informationen, die an den jeweiligen Pins anliegen.

Bequemer Zugriff auf die individuellen Bits erleichtert die Interaktion mit externer Hardware (Bild 2)

Bequemer Zugriff auf die individuellen Bits erleichtert die Interaktion mit externer Hardware (Bild 2)

© Microchip Technology

Aufgrund der doch weiten Verbreitung solcher Anwendungszwecke bringt das .NET-Framework per se Unterstützung für Bitflags mit. Eine mit dem Flags-Attribut ausgestattete Enum agiert nach folgendem Schema als digitales Abbild eines Bitfelds:

 

[Flags]
enum Bitfeld {
    None = 0,
    A = 1,
    B = 2,
    C = 4,
    D = 8,
    E = 16,
    F = 32
}

 

Die Nutzung von Enum.NET ist bei der Verarbeitung von Bitfeldern insofern anwenderfreundlich, als sie die von Haus aus vorhandene HasFlag-Funktion um einige durchaus hilfreiche Convenience-Funktionen ergänzt. Diese ersparen uns Entwicklern die Bit-Manipulation, die sich in der Praxis doch häufig als unsichere und kritische Programmieraufgabe herausstellt.

Als ersten Anwendungsfall sehen wir uns die Methoden HasAnyFlags und HasAllFlags an. Sie überprüfen, ob die als Basis verwendete Enum entweder zumindest eine oder aber alle der als Parameter übergebenen Bitflags setzt:

 

static void Main(string[] args)
{
    Bitfeld musik = Bitfeld.A | Bitfeld.C | Bitfeld.F;
    Console.WriteLine(musik.HasAnyFlags(Bitfeld.A | Bitfeld.B));
    Console.WriteLine(musik.HasAllFlags(Bitfeld.A | Bitfeld.B));
}

 

Außerdem ist es möglich, nach dem gezeigten Schema eine Zerlegung des Bitfelds durchzuführen. Der Iterator liefert hier der Reihe nach alle gesetzten Bits:

 

Console.WriteLine("Aktive Flags einzeln:");
foreach (Bitfeld flag in musik.GetFlags())
{
    Console.WriteLine($"- {flag}");
}

 

Bild 3 zeigt das Ergebnis der Programm-Ausführung.

Die Nutzung der NuGet-Erweiterung erleichtert die Arbeit mit Bitfeldern immens (Bild 3)

Die Nutzung der NuGet-Erweiterung erleichtert die Arbeit mit Bitfeldern immens (Bild 3)

© Autor

Validation der in Enums und Flags enthaltenen Werte

Enums sind in C# nicht streng typisiert. Das bedeutet, dass ein bösartiger Programmierer mehr oder weniger beliebige Werte in Enum-typisierte Variablen schreiben darf.

Zur Illustration dieser Vorgehensweise wollen wir die von weiter oben bekannte Wochentags-Enum abermals betrachten – sie deckt ja nur die Werte von Montag bis zum Fauchtag ab. Das Einschreiben eines beliebigen numerischen Werts wie 99 hat deshalb das Potenzial, das korrekte Funktionieren des Programms zu stören.

Enums.NET begegnet diesem Problem durch eine Komfortfunktion, die sich wie im folgenden Sektor präsentiert:

 

static void Main(string[] args) {
    Wochentag falscherTag = (Wochentag)99;
    Console.WriteLine(Enums.IsValid(falscherTag));
}

Fazit

Werkzeuge müssen nicht immens komplex sein, um hohen Nutzwert aufzuweisen. Wer gerne Enums verwendet und bisher jede Menge Glue-Code von Hand mitschleppen musste, findet hier einen bequemen alternativen Weg.

Neueste Beiträge

Mit Sixel dynamisch Bitmaps erstellen und in die .NET-Konsole rendern - Retro-Hardware mit .NET in Software nachbilden, Teil 3
Der bereits in den 1980ern entwickelte Sixel-Standard ermöglicht uns noch heute, in der Konsole auf einfache Weise Bilder und kleinere Visualisierungen darzustellen – portabel und ohne weitere Abhängigkeiten.
8 Minuten
12. Nov 2026
Review von KI-generiertem Code - Projektanforderungen an Entwickler in Zeiten von KI, Teil 3
Der Code kompiliert. Die Tests sind grün. Der Pull Request sieht sauber aus. Und trotzdem ist er falsch. Fünf Fehlermuster zeigen, worauf die Reviewer beim KI-generierten Code achten müssen, weil Syntax-Korrektheit längst nicht Geschäftslogik-Korrektheit bedeutet.
6 Minuten
Von Vibe Coding zur verlässlichen Anwendung - Was KI-generierte Anwendungen für den produktiven Einsatz brauchen
Der Beitrag zeigt, wie Spec-Driven Development natürliche Sprache mit verbindlichen Anforderungen an Qualität, Verantwortung und langfristige Wartbarkeit verbindet.
8 Minuten
9. Nov 2026

Das könnte Dich auch interessieren

Python in .NET – Integration mit Python.NET - .NET, Python und KI, Teil 1
Python-Code lässt sich in .NET-Anwendungen mit dem Open-Source-Projekt Python.NET einbinden. Wir erklären die Installation und grundlegende Interop-Szenarien. Ein einfaches Beispiel veranschaulicht die Praxis.
6 Minuten
Frühjahrsputz für .NET - Alte .NET-Versionen entfernen
Immer mehr .NET-Versionen sammeln sich auf der Festplatte an. Höchste Zeit, wieder Platz zu schaffen.
14 Minuten
.NET-Color-Picker für WPF- und Avalonia-Applikationen - Best of NuGet, Teil 7
Mit PixiEditor.ColorPicker steht eine Bibliothek in den Startlöchern, die Entwicklern von Desktop-zentrierten Applikationen verschiedene hochwertige Farbauswahldialoge zur Verfügung stellt.
6 Minuten
20. Jul 2026
Anzeige
Anzeige
Anzeige
Anzeige
Anzeige