enum

Un type énumération (également appelé énumération ou enum) offre un moyen efficace de définir un ensemble de constantes intégrales nommées qui peuvent être assignées à une variable. Par exemple, supposez que vous devez définir une variable dont la valeur représente un jour de la semaine. Il n'y a que sept valeurs significatives qui pourront être stockées par cette variable. Pour définir ces valeurs, vous pouvez utiliser un type énumération, qui est déclaré à l'aide du mot clé enum.

Par défaut, le type sous-jacent de chaque élément dans l'énumération est int. Vous pouvez spécifier un autre type numérique intégral à l'aide d'un signe deux-points, comme illustré dans l'exemple précédent. Pour obtenir une liste complète des types possibles, consultez enum (référence C#).

Vous pouvez vérifier les valeurs numériques sous-jacentes en effectuant un cast sur le type sous-jacent, comme le montre l'exemple suivant.

Voici les avantages qu'offre l'utilisation d'un enum par rapport à un type numérique :

Vous spécifiez clairement pour le code client les valeurs qui sont valides pour la variable. Dans Visual Studio, IntelliSense liste les valeurs définies.

Quand vous ne spécifiez pas de valeurs pour les éléments dans la liste d'énumérateurs, les valeurs sont automatiquement incrémentées de 1. Dans l'exemple précédent, Day.Sunday a la valeur 0, Day.Monday a la valeur 1 et ainsi de suite. Quand vous créez un objet Day, il a la valeur par défaut Day.Sunday (0) si vous ne lui assignez pas une valeur explicitement. Quand vous créez un enum, sélectionnez la valeur par défaut la plus logique et affectez-lui une valeur égale à zéro. Ainsi, tous les enums auront cette valeur par défaut si aucune valeur ne leur est assignée explicitement lors de leur création.

Si la variable meetingDay est de type Day, alors (sans un cast explicite) vous pouvez uniquement lui affecter l'une des valeurs définies par Day. Si le jour de la réunion change, vous pouvez affecter une nouvelle valeur de Day à meetingDay :


Vous pouvez affecter n'importe quelle valeur aux éléments dans la liste d'énumérateurs d'un type énumération, et vous pouvez également utiliser des valeurs calculées :

Types énumération comme indicateurs binaires

Vous pouvez utiliser un type énumération pour définir des indicateurs binaires, ce qui permet à une instance du type énumération de stocker n'importe quelle combinaison des valeurs définies dans la liste d'énumérateurs. (Bien entendu, certaines combinaisons peuvent ne pas être significatives ou autorisées dans votre code de programme.)

Pour créer un enum d'indicateurs binaires, vous devez appliquer l'attribut System.FlagsAttribute et définir les valeurs de manière appropriée afin que les opérations au niveau du bit AND, OR, NOT et XOR puissent être effectuées sur elles. Dans l'enum d'indicateurs binaires, incluez une constante nommée avec une valeur zéro qui signifie "aucun indicateur n'est défini." N'attribuez pas la valeur zéro à un indicateur si cela ne signifie pas "aucun indicateur n'est défini".

Dans l'exemple suivant, une autre version de l'enum Day, nommée Days, est définie. Days a l'attribut Flags, et à chaque valeur est affectée la puissance de deux supérieure suivante. Cela vous permet de créer une variable Days dont la valeur est Days.Tuesday | Days.Thursday.

Pour définir un indicateur sur un enum, utilisez l'opérateur binaire OR comme indiqué dans l'exemple suivant :

Pour déterminer si un indicateur spécifique est défini, utilisez une opération AND au niveau du bit, comme indiqué dans l'exemple suivant :

Pour plus d'informations sur les éléments à prendre en compte quand vous définissez des types énumération avec l'attribut System.FlagsAttribute, consultez System.Enum.

Utilisation des méthodes System.Enum pour découvrir et manipuler des valeurs enum

Tous les enums sont des instances du type System.Enum. Vous ne pouvez pas dériver de nouvelles classes à partir de System.Enum, mais vous pouvez utiliser ses méthodes pour découvrir des informations et manipuler les valeurs d'une instance enum.