Enum.Format(Type, Object, String) Méthode

Définition

Espace de noms:
System
Assemblys:
mscorlib.dll, System.Runtime.dll
Assemblys:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Source:
Enum.cs
Source:
Enum.cs
Source:
Enum.cs
Source:
Enum.cs
Source:
Enum.cs

Convertit la valeur spécifiée d’un type énuméré spécifié en sa représentation sous forme de chaîne équivalente selon le format spécifié.

public:
 static System::String ^ Format(Type ^ enumType, System::Object ^ value, System::String ^ format);
public static string Format(Type enumType, object value, string format);
[System.Runtime.InteropServices.ComVisible(true)]
public static string Format(Type enumType, object value, string format);
static member Format : Type * obj * string -> string
[<System.Runtime.InteropServices.ComVisible(true)>]
static member Format : Type * obj * string -> string
Public Shared Function Format (enumType As Type, value As Object, format As String) As String

Paramètres

enumType
Type

Type d’énumération de la valeur à convertir.

value
Object

Valeur à convertir.

format
String

Format de sortie à utiliser.

Retours

String

Représentation sous forme de chaîne de value.

Attributs
ComVisibleAttribute

Exceptions

ArgumentNullException

Le , enumTypeou value le formatparamètre est null.

ArgumentException

Le enumType paramètre n’est pas un Enum type.

- ou -

Il value s’agit d’une énumération qui diffère du type .enumType

- ou -

Le type de value n’est pas un type sous-jacent de enumType.

FormatException

Le format paramètre contient une valeur non valide.

InvalidOperationException

format est égal à « X », mais le type d’énumération est inconnu.

- ou -

.NET 8 et versions ultérieures : enumType est un type d’énumération booléen.

Exemples

L’exemple suivant illustre l’utilisation dans Format le contexte de Enum.

using System;

enum Colors { Red, Green, Blue, Yellow };

public class FormatTest {
    public static void Main() {
        Colors myColor = Colors.Blue;

        Console.WriteLine("My favorite color is {0}.", myColor);
        Console.WriteLine("The value of my favorite color is {0}.", Enum.Format(typeof(Colors), myColor, "d"));
        Console.WriteLine("The hex value of my favorite color is {0}.", Enum.Format(typeof(Colors), myColor, "x"));
    }
}
// The example displays the following output:
//    My favorite color is Blue.
//    The value of my favorite color is 2.
//    The hex value of my favorite color is 00000002.

open System

type Colors =
    | Red = 0
    | Green = 1
    | Blue = 2
    | Yellow = 3

let myColor = Colors.Blue

printfn $"My favorite color is {myColor}."
printfn $"""The value of my favorite color is {Enum.Format(typeof<Colors>, myColor, "d")}."""
printfn $"""The hex value of my favorite color is {Enum.Format(typeof<Colors>, myColor, "x")}."""
// The example displays the following output:
//    My favorite color is Blue.
//    The value of my favorite color is 2.
//    The hex value of my favorite color is 00000002.

 Enum Colors
     Red
     Green
     Blue
     Yellow    
 End Enum
    
Public Class FormatTest
    Public Shared Sub Main()
        Dim myColor As Colors = Colors.Blue
        
        Console.WriteLine("My favorite color is {0}.", myColor)
        Console.WriteLine("The value of my favorite color is {0}.", [Enum].Format(GetType(Colors), myColor, "d"))
        Console.WriteLine("The hex value of my favorite color is {0}.", [Enum].Format(GetType(Colors), myColor, "x"))
    End Sub 
End Class 
' The example displays the following output:
'    My favorite color is Blue.
'    The value of my favorite color is 2.
'    The hex value of my favorite color is 00000002.

Remarques

Le tableau suivant présente les valeurs valides pour le format paramètre.

Format Description
"G" ou "g" Si value elle est égale à une constante énumérée nommée, le nom de cette constante est retourné ; sinon, l’équivalent décimal est value retourné.

Par exemple, supposons que la seule constante énumérée est nommée Rouge et que sa valeur est 1. Si value elle est spécifiée comme 1, ce format retourne « Rouge ». Toutefois, s’il value est spécifié comme 2, ce format retourne « 2 ».

- ou -

Si l’attribut FlagsAttribute personnalisé est appliqué à l’énumération, value est traité comme un champ de bits qui contient un ou plusieurs indicateurs qui se composent d’un ou plusieurs bits.

Si value elle est égale à une combinaison de constantes énumérées nommées, une liste séparée par un délimiteur des noms de ces constantes est retournée. value recherche des indicateurs, allant de l’indicateur avec la plus grande valeur à la plus petite valeur. Pour chaque indicateur qui correspond à un champ de bits, valuele nom de la constante est concaténé à la liste séparée par un délimiteur. La valeur de cet indicateur est ensuite exclue d’une autre considération, et la recherche continue pour l’indicateur suivant.

Si value elle n’est pas égale à une combinaison de constantes énumérées nommées, l’équivalent décimal est value retourné.
"X" ou "x" Représente value au format hexadécimal sans « 0x » de début.
"D" ou "d" Représente value sous forme décimale.
"F" ou "f" Se comporte de la même façon que « G » ou « g », sauf que l’élément FlagsAttribute n’est pas requis pour être présent sur la Enum déclaration.

S’applique à

Voir aussi