Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

Chaînes de format d'énumération

Vous pouvez utiliser la méthode Enum.ToString pour créer un nouvel objet chaîne qui représente la valeur numérique, hexadécimale ou de chaîne d'un membre de l'énumération. 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. L'exemple suivant illustre le spécificateur de format G.


Console.WriteLine(ConsoleColor.Red.ToString("G"));         // Displays Red
FileAttributes attributes = FileAttributes.Hidden |
                            FileAttributes.Archive;
Console.WriteLine(attributes.ToString("G"));   // Displays Hidden, Archive                               


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. L'exemple suivant illustre le spécificateur de format F.


Console.WriteLine(ConsoleColor.Blue.ToString("F"));       // Displays Blue
FileAttributes attributes = FileAttributes.Hidden | 
                            FileAttributes.Archive;
Console.WriteLine(attributes.ToString("F"));   // Displays Hidden, Archive                               


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. L'exemple suivant illustre le spécificateur de format D.


Console.WriteLine(ConsoleColor.Cyan.ToString("D"));         // Displays 11
FileAttributes attributes = FileAttributes.Hidden |
                            FileAttributes.Archive;
Console.WriteLine(attributes.ToString("D"));                // Displays 34                               


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 illustre le spécificateur de format X.


Console.WriteLine(ConsoleColor.Cyan.ToString("X"));   // Displays 0000000B
FileAttributes attributes = FileAttributes.Hidden |
                            FileAttributes.Archive;
Console.WriteLine(attributes.ToString("X"));          // Displays 00000022                               


L'exemple suivant définit une énumération appelée Colors qui se compose de trois entrées : Red, Blue et Green.


public enum Color {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.


Color myColor = Color.Green;      


La méthode Color.ToString(System.String) peut ensuite être utilisée pour afficher la valeur d'énumération de différentes façons, selon le spécificateur de format qui lui est passé.


Console.WriteLine("The value of myColor is {0}.", 
                  myColor.ToString("G"));
Console.WriteLine("The value of myColor is {0}.", 
                  myColor.ToString("F"));
Console.WriteLine("The value of myColor is {0}.", 
                  myColor.ToString("D"));
Console.WriteLine("The value of myColor is 0x{0}.", 
                  myColor.ToString("X"));
// The example displays the following output to the console:
//       The value of myColor is Green.
//       The value of myColor is Green.
//       The value of myColor is 3.
//       The value of myColor is 0x00000003.      


Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft