Énumération en C#

Enum est un mot-clé réservé en C#, qui représente une énumération. Une énumération est un type défini par l'utilisateur en C# qui contient un ensemble de constantes nommées. Chaque constante de l'ensemble a une valeur (par défaut, des nombres entiers). Les constantes sont accessibles via les noms et les valeurs. Ainsi, les noms ne peuvent pas être dupliqués dans une énumération. La syntaxe d'une énumération est simple. Il commence par le mot-clé enum, suivi d'un nom de variable et d'un ensemble de constantes nommées entourées d'accolades. Bien sûr, cela se termine par un point-virgule.

Syntaxe :

enum <enum_name> {<set_of_named_constants>};

Exemple :

Code :

enum Day { Sun, Mon, Tue, Wed, Thu, Fri, Sat };
enum Month { Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec };

Fonctionnement d'Enum en C#

Les énumérations ont un type sous-jacent en C#. Cela signifie que chaque constante de l'énumération aura une valeur du type sous-jacent qui lui sera assignée. Le type d'énumération sous-jacent par défaut en C# est un entier.

Dans l'énumération Day ci-dessus, nous avons sept constantes déclarées. Il a un type entier sous-jacent par défaut. Ainsi, chaque constante se verra attribuer une valeur entière. Par défaut, la valeur commence à 0. Ainsi, Sun se verra attribuer 0 ; Mon en aura 1, Tue en aura 2, et ainsi de suite.

Prenons un autre exemple. Nous attribuerions la valeur 1 à Sun. Cela forcerait le compilateur à démarrer l'affectation à partir de 1 au lieu de 0. Ensuite, nous attribuerions la valeur 8 à Thu. Le compilateur continuerait alors la mission à partir de 8.

Exemple n°1

Code :

using System;
public class Program
{
enum Day
{
Sun = 1,
Mon,
Tue,
Wed,
Thu = 8,
Fri,
Sat
};
public static void Main()
{
for (int i = 0; i < 10; i++)
{
Console.WriteLine((Day)i);
}
}
}

Sortie :

Un exemple concret peut être les différentes étapes du parcours d’un client. Bien sûr, toutes les constantes peuvent être déclarées séparément et leur attribuer des valeurs entières correspondantes, mais l'utilisation d'une énumération élimine les tracas liés à la mémorisation des valeurs entières pour chaque étape et rend le code beaucoup plus facile à comprendre.

Exemple n°2

Code :

using System;
public class Program
{
enum ClientJourney
{
Introduced = 1,
UnderReview = 2,
Reviewed = 3,
Documentation = 4,
Onboarded = 5,
Declined = 6,
Deboarded = 7
};
public static void Main()
{
Console.WriteLine("The various stages in the journey of a client are:\n");
foreach (string str in Enum.GetNames(typeof(ClientJourney)))
{
Console.WriteLine(str);
}
}
}

Sortie :

Méthodes d'énumération en C#

Vous trouverez ci-dessous les méthodes d'énumération en C# :

1. ObtenirNom(Type, Int32)

La méthode GetName renvoie la constante nommée mappée à la valeur spécifiée dans l'énumération. S'il n'y a pas de constante nommée à cette valeur, elle renvoie une chaîne vide.

Cette méthode attend deux paramètres : l'un est le type, c'est-à-dire l'énumération elle-même, et l'autre est la valeur spécifiée.

Dans le même exemple de Days ci-dessus, nous imprimerions les constantes nommées via la méthode GetName.

Code :

using System;
public class Program
{
enum Day
{
Sun = 1,
Mon,
Tue,
Wed,
Thu = 8,
Fri,
Sat
}
;
public static void Main()
{
for (int i = 0; i < 10; i++)
{
Console.WriteLine(Enum.GetName(typeof(Day), i));
}
}
}

Sortie :

2. ObtenirNoms(Type)

Dans l'exemple ci-dessus, nous avons dû utiliser la boucle for pour récupérer toutes les constantes nommées de l'énumération. La méthode GetName est plus utile lorsque nous avons besoin d'une seule ou d'un nombre limité de constantes nommées.

Nous avons une autre méthode GetNames() pour obtenir toutes les constantes nommées. Il prend l'énumération comme paramètre d'entrée.

Dans le même exemple de Days ci-dessus, nous imprimerions les constantes nommées via la méthode GetNames.

Code :

using System;
public class Program
{
enum Day
{
Sun = 1,
Mon,
Tue,
Wed,
Thu = 8,
Fri,
Sat
}
;
public static void Main()
{
foreach(string namedConstant in Enum.GetNames(typeof(Day))){
Console.WriteLine(namedConstant);
}
}
}

Sortie :

3. ObtenirValeurs(Type)

La méthode GetValues() est utilisée pour obtenir les valeurs mappées sous-jacentes à chacune des constantes nommées de l'énumération.

Dans le même exemple de Days ci-dessus, nous imprimerions les constantes nommées via la méthode GetNames.

Code :

using System;
public class Program
{
enum Day
{
Sun = 1,
Mon,
Tue,
Wed,
Thu = 8,
Fri,
Sat
}
;
public static void Main()
{
foreach (int i in Enum.GetValues(typeof(Day)))
{
Console.WriteLine(i);
}
}
}

Sortie :

Règles pour Enum en C#

Vous trouverez ci-dessous les règles pour l'énumération en C# :

• Enum est un type, pas une variable/constante/méthode.
• Les constantes nommées enum ne peuvent pas être dupliquées. Ils doivent être uniques.
• Le type sous-jacent de l'énumération ne peut pas être char.
• Le type d'énumération sous-jacent par défaut est un entier.
• Par défaut, les valeurs attribuées aux constantes nommées enum commencent à 0, augmentant de 1 pour chaque constante nommée successivement.

Avantages d'Enum en C#

Vous trouverez ci-dessous les avantages mentionnés :

• Les énumérations sont une très bonne pratique de codage. Ils permettent de définir l'ensemble des constantes de l'application ou du programme. Ainsi, l'ensemble reste constant et évite le chaos dans le programme, surtout lorsqu'il s'agit d'une vaste application impliquant plusieurs développeurs.
• Il existe de nombreux scénarios dans lesquels les énumérations peuvent être utilisées. Jours de la semaine, mois de l'année, taux de conversion pour les températures, facteurs de conversion pour les fuseaux horaires ou toute donnée de table principale pour l'application. Cela rend le code plus lisible et plus facile à comprendre.

Conclusion

Ainsi, nous avons vu l’utilisation de l’énumération en C#. Nous avons vu comment cela fonctionne et quelle peut être son utilisation pratique. Nous avons compris les règles à respecter lors de l'utilisation des énumérations. Certaines méthodes nous aident à accéder et à formater l'énumération. Il est recommandé d'utiliser autant que possible des énumérations dans votre code. Cela vous aidera à observer les bonnes pratiques de codage et à apprendre également les énumérations.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!