Chaînes de format d'énumération
Vous pouvez utiliser la méthode ToString pour créer un nouvel objet chaîne qui représente la valeur numérique, hexadécimale ou de chaîne de Enum. Cette méthode prend une des chaînes de format d'énumération pour spécifier la valeur à retourner.
Le tableau suivant répertorie les chaînes de format d'énumération et les valeurs qu'elles retournent. Ces spécificateurs de format ne respectent pas la casse.
| Chaîne de format | Résultat |
|---|---|
G ou g |
Affiche l'entrée d'énumération sous la forme d'une valeur de chaîne dans la mesure du possible ; sinon, affiche la valeur entière de l'instance actuelle. Si l'énumération est configurée et si l'attribut Flags est défini, les valeurs de chaîne de chaque entrée valide sont concaténées ensemble, séparées par des virgules. Si l'attribut Flags n'est pas défini, une valeur non valide s'affiche comme entrée numérique. |
F ou f |
Affiche, dans la mesure du possible, l'entrée d'énumération en tant que valeur de chaîne. Si la valeur peut être complètement affichée en tant que somme des entrées de l'énumération (même en cas d'absence de l'attribut Flags), les valeurs de chaîne de chaque entrée valide sont concaténées ensemble, séparées par des virgules. Si la valeur ne peut pas être complètement déterminée par les entrées de l'énumération, la valeur est mise en forme en tant que valeur entière. |
D ou d |
Affiche l'entrée d'énumération sous la forme d'une valeur entière dans la plus courte représentation possible. |
X ou x |
Affiche l'entrée d'énumération sous la forme d'une valeur hexadécimale. La valeur est représentée avec des zéros à gauche le cas échéant, pour garantir que la valeur comprend au moins huit chiffres. |
L'exemple suivant définit une énumération appelée Colors constituée de trois entrées : Red, Blue et Green.
Public Enum Colors
Red = 1
Blue = 2
Green = 3
End Enum
public enum Colors{Red = 1, Blue = 2, Green = 3}
Une fois l'énumération définie, une instance peut être déclarée de la manière suivante.
Dim MyColors As Colors = Colors.Green
Colors MyColors = Colors.Green;
L'exemple suivant utilise les méthodes de mise en forme d'énumération pour assigner des représentations sous la forme numérique, hexadécimale ou de chaîne d'une énumération DayOfWeek à la chaîne MyString. Ce code crée une nouvelle instance de l'énumération DayOfWeek appelée MyDays et lui assigne la valeur Friday. Ensuite, il utilise les chaînes de format « G », « F », « D » et « X » pour assigner des représentations d'énumération différentes à MyString.
Dim MyDays As DayOfWeek = DayOfWeek.Friday
Dim MyString As String = MyDays.ToString("G")
' In the U.S. English culture, MyString has the value: "Friday".
MyString = MyDays.ToString("F")
' In the U.S. English culture, MyString has the value: "Friday".
MyString = MyDays.ToString("D")
' In the U.S. English culture, MyString has the value: "5".
MyString = MyDays.ToString("X")
' In the U.S. English culture, MyString has the value: "00000005".
DayOfWeek MyDays = DayOfWeek.Friday;
String MyString = MyDays.ToString("G");
// In the U.S. English culture, MyString has the value: "Friday".
MyString = MyDays.ToString("F");
// In the U.S. English culture, MyString has the value: "Friday".
MyString = MyDays.ToString("D");
// In the U.S. English culture, MyString has the value: "5".
MyString = MyDays.ToString("X");
// In the U.S. English culture, MyString has the value: "00000005".