C# Enum(Enumeration) med eksempel

Af: Benjamin rollator Benjamin rollator
Hours Opdateret

⚡ Smart opsummering

Optællinger i C# definerer et navngivet sæt af konstante integralværdier, såsom ugedagene, hvilket gør kode nemmere at læse og vedligeholde. Nøgleordet enum deklarerer disse faste konstanter én gang til genbrug på tværs af et program.

  • 📐 Definition: Enum-nøgleordet grupperer relaterede navngivne konstanter under én type og erstatter spredte magiske tal med læsbare identifikatorer.
  • ️ Eksempel på dage: En optælling kaldet Days gemmer ugedage, og Days.Sun returnerer det valgte medlem ved dets navn.
  • 🔢 Underliggende værdier: Enum-medlemmer knyttes til heltalsværdier, der starter ved nul og stiger med én, medmindre der tildeles brugerdefinerede tal.
  • 🔁 Konverteringer: Eksplicite casts omdanner en enum til dens heltal, mens Enum.Parse og Enum.TryParse konverterer tekst tilbage til medlemmer.
  • 🚩 Flag: Flags-attributten lader en enum kombinere flere muligheder som bitfelter ved hjælp af den bitvise OR-operator.
  • 🤖 AI assistance: GitHub Copilot og ML.NET hjælper med at generere enum-definitioner og knytte enums til maskinlæringsfunktioner.
Læs mere

C# Optælling (Enumeration)

C# optælling

En opregning bruges i ethvert programmeringssprog til at definere et konstant sæt værdier. For eksempel kan ugedagene defineres som en opregning og bruges hvor som helst i programmet. I C# defineres opregningen ved hjælp af søgeordet 'enum'.

Lad os se et eksempel på, hvordan vi kan bruge søgeordet 'enum'.

I vores eksempel vil vi definere en opregning kaldet dage, som vil blive brugt til at gemme ugedagene. For hvert eksempel vil vi kun ændre hovedfunktionen i vores Program.cs-fil.

C# optælling

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
namespace DemoApplication
{
 class Program 
 {
  enum Days{Sun,Mon,tue,Wed,thu,Fri,Sat};
  
  static void Main(string[] args) 
  {
   Console.Write(Days.Sun);
   
   Console.ReadKey();
  }
 }
}

Code Forklaring:-

  1. 'Enum' datatype er specificeret til at erklære en opregning. Navnet på opregningen er Dage. Alle ugens dage er angivet som værdier for opregningen.
  2. Endelig bruges console.write-funktionen til at vise en af ​​værdierne i opregningen.

Hvis ovenstående kode er indtastet korrekt, og programmet udføres korrekt, vil følgende output blive vist.

Output:

C# optælling

Fra outputtet kan du se, at 'Sun'-værdien for opregningen vises i konsollen.

Hvorfor bruge enums i C#?

Enums gør et program nemmere at læse, mere sikkert og enklere at vedligeholde. I stedet for at sprede uforklarlige tal, nogle gange kaldet magiske tal, ud over hele koden, giver en enumeration hver værdi et beskrivende navn, der angiver dens hensigt.

  • Læsbarhed: Et navn som Days.Fri er langt tydeligere end tallet 5, så alle, der læser koden, forstår betydningen med det samme.
  • Type sikkerhed: En variabel, der er deklareret med en enum-type, kan kun indeholde ét af de definerede medlemmer, hvilket forhindrer ugyldige værdier i at glideping i.
  • Vedligeholdelse: Relaterede konstanter findes på ét sted, så tilføjelse eller omdøbning af en værdi opdaterer hele programmet konsekvent.
  • Databinding: Frameworks som WPF og ASP.NET kan binde en enum til en rulleliste, hvilket gør enums nyttige til at bygge brugergrænseflader.

Fordi compileren kontrollerer hver tildeling mod de tilladte medlemmer, hjælper enums også med at opdage fejl tidligt, før programmet kører.

Tildeling af brugerdefinerede værdier til en C#-enum

Som standard tildeler C# det første enum-medlem værdien 0 og øger hvert efterfølgende medlem med én. I Days-optællingen ovenfor er Sun lig med 0, Mon lig med 1, og Sat lig med 6. Du kan tilsidesætte disse standardværdier ved at tildele eksplicitte tal.

  • Eksplicitte værdier: Skrivning af enumniveau {Lav = 1, Mellem = 5, Høj = 10} sætter hvert medlem til et valgt tal i stedet for standardsekvensen.
  • Delvis opgave: Hvis du kun tildeler en værdi til nogle medlemmer, fortsætter compileren med at nummerere fra den sidst tildelte værdi for de efterfølgende medlemmer.
  • Underliggende type: En enum gemmer sine medlemmer som standard som int, men du kan basere den på byte, short eller long for at spare hukommelse eller udvide området.

Brugerdefinerede værdier er nyttige, når tallene skal matche et eksternt system, f.eks. databasekoder eller protokolkonstanter, så enum-værdien afspejler de faktiske data nøjagtigt.

RELATEREDE ARTIKLER

Sådan konverterer du C# Enums til int, string og flag

C# har ofte brug for at flytte en enum-værdi til en anden form, f.eks. ved at gemme den som et tal eller læse den tilbage fra tekst. Disse konverteringer sker på et par standardmåder.

  • Optælling til int: En eksplicit cast som (int)Days.Wed returnerer det underliggende heltal, hvilket er nyttigt til lagring eller aritmetik.
  • int til optælling: Hvis man caster i den anden retning, for eksempel (Days)3, omdannes et tal tilbage til det matchende enum-medlem.
  • Streng at optælle: Enum.Parse og den sikrere Enum.TryParse konverterer et navn som "Fri" til Days.Fri-medlemmet uden at tilføje ugyldig tekst.
  • Optælling til streng: Hvis et kald af ToString på et medlem returneres dets navn, så Days.Sun.ToString() producerer "Sun" til visning eller logføring.
  • Medlemmer på listen: Enum.GetValues ​​og Enum.GetNames returnerer alle værdier eller navne, hvilket er nyttigt, når menuer udfyldes eller input valideres.

Når en enum skal repræsentere en kombination af valgmuligheder i stedet for én, skal du anvende attributten Flags og give hvert medlem en potens af to, f.eks. 1, 2, 4 og 8. Du kan derefter kombinere medlemmer med den bitvise ELLER-operator og teste for en specifik mulighed med HasFlag-metoden.

Disse konverteringsteknikker gør det muligt for en enum at bevæge sig nemt mellem læsbare navne, gemte tal og kombinerede flagsæt, keeping Resten af ​​programmet er både skrivesikkert og let at følge.

Ofte Stillede Spørgsmål

En enum-variabel har som standard værdien 0, hvor værdien er knyttet til det medlem, der er lig med 0. Hvis intet medlem er 0, har variablen stadig værdien 0, så udviklere definerer ofte først et Ingen- eller Ukendt-medlem for at undgå forvirring.

En const definerer én navngiven værdi, mens en enum grupperer et relateret sæt af navngivne konstanter under en enkelt type. Enums tilføjer også typesikkerhed, fordi en variabel kun kan indeholde et af optællingens definerede medlemmer.

Ja. En enum kan deklareres i et navnerum eller indlejres i en klasse eller struktur, hvilket begrænser dens omfang til den pågældende type. C# tillader dog ikke, at en enum deklareres i en metodes indhold.

Ja. To eller flere medlemmer kan dele det samme underliggende nummer, hvilket gør de senere navne til aliaser af det første. Sammenligninger behandler dem som ligeværdige, og konvertering af denne værdi til en streng returnerer det navn, der er defineret først i enum.

En enum er en værditype, så den gemmer sine data direkte i stedet for som en reference på heapen. Den arver fra System.Enum, men opfører sig som integraltypen nedenunder, hvilket gør kopiering og sammenligning af enum-værdier hurtig.

Ja. I ML.NET kan du knytte en enum til en kategorisk funktion eller etiket, ofte ved at konvertere den til dens heltalsværdi eller en one-hot-kodning. Stærkt typede enums holder inputkolonnerne i en maskinlæringspipeline klare og konsistente.

Ja. GitHub Copilot foreslår komplette enum-definitioner, brugerdefinerede værdier, Flags-attributter og konverteringshjælpere såsom Enum.TryParse i Visual Studio og VS Code. RevSe hvert forslag, da Copilot kan vælge værdier eller navne, der ikke passer til dit domæne.

Brug metoden Enum.IsDefined, som returnerer sand, når et givet tal eller navn matcher et defineret medlem. Ved at parre den med Enum.TryParse kan du validere brugerinput sikkert, før tekst konverteres til en enum-værdi.

Opsummer dette indlæg med: