Enum.GetName Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Surcharges

GetName(Type, Object)	Récupère le nom de la constante dans l'énumération spécifiée associée à la valeur spécifiée.
GetName<TEnum>(TEnum)	Récupère le nom de la constante dans le type d’énumération spécifié associé à la valeur spécifiée.

GetName(Type, Object)

Source:

Enum.cs

Récupère le nom de la constante dans l'énumération spécifiée associée à la valeur spécifiée.

public:
 static System::String ^ GetName(Type ^ enumType, System::Object ^ value);

public static string? GetName (Type enumType, object value);

static member GetName : Type * obj -> string

Public Shared Function GetName (enumType As Type, value As Object) As String

Paramètres

enumType

Type

Type énumération.

value

Object

Valeur d’une constante énumérée qui a un type sous-jacent particulier.

Retours

String

Chaîne contenant le nom de la constante énumérée dans enumType dont la valeur est value, ou null si aucune constante de ce type n'est trouvée.

Exceptions

ArgumentNullException

enumType ou value est null.

ArgumentException

enumType n'est pas Enum.

- ou -

value n’est pas de type enumType et n’a pas le même type sous-jacent qu’enumType.

InvalidOperationException

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

Exemples

L'exemple suivant illustre l'utilisation de GetName.

using namespace System;

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

enum class Styles
{
   Plaid, Striped, Tartan, Corduroy
};

int main()
{
   Console::WriteLine(  "The 4th value of the Colors Enum is {0}", Enum::GetName( Colors::typeid, 3 ) );
   Console::WriteLine(  "The 4th value of the Styles Enum is {0}", Enum::GetName( Styles::typeid, 3 ) );
}
// The example displays the following output:
//       The 4th value of the Colors Enum is Yellow
//       The 4th value of the Styles Enum is Corduroy

using System;

public class GetNameTest {
    enum Colors { Red, Green, Blue, Yellow };
    enum Styles { Plaid, Striped, Tartan, Corduroy };

    public static void Main() {

        Console.WriteLine("The 4th value of the Colors Enum is {0}", Enum.GetName(typeof(Colors), 3));
        Console.WriteLine("The 4th value of the Styles Enum is {0}", Enum.GetName(typeof(Styles), 3));
    }
}
// The example displays the following output:
//       The 4th value of the Colors Enum is Yellow
//       The 4th value of the Styles Enum is Corduroy

open System

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

type Styles =
    | Plaid = 0
    | Striped = 1
    | Tartan = 2
    | Corduroy = 3

printfn $"The 4th value of the Colors Enum is {Enum.GetName(typeof<Colors>, 3)}"
printfn $"The 4th value of the Styles Enum is {Enum.GetName(typeof<Styles>, 3)}"
// The example displays the following output:
//       The 4th value of the Colors Enum is Yellow
//       The 4th value of the Styles Enum is Corduroy

Public Class GetNameTest
    
    Enum Colors
        Red
        Green
        Blue
        Yellow
    End Enum 'Colors
    
    Enum Styles
        Plaid
        Striped
        Tartan
        Corduroy
    End Enum 'Styles
    
    Public Shared Sub Main() 
        Console.WriteLine("The 4th value of the Colors Enum is {0}", [Enum].GetName(GetType(Colors), 3))
        Console.WriteLine("The 4th value of the Styles Enum is {0}", [Enum].GetName(GetType(Styles), 3))
    End Sub
End Class
' The example displays the following output:
'       The 4th value of the Colors Enum is Yellow
'       The 4th value of the Styles Enum is Corduroy

Remarques

Si plusieurs membres d’énumération ont la même valeur sous-jacente, la GetName méthode garantit qu’elle retourne le nom de l’un de ces membres d’énumération. Toutefois, cela ne garantit pas qu’il retourne toujours le nom du même membre d’énumération. Par conséquent, lorsque plusieurs membres d’énumération ont la même valeur, votre code d’application ne doit jamais dépendre de la méthode qui retourne le nom d’un membre particulier.

GetName<TEnum>(TEnum)

Source:

Enum.cs

Récupère le nom de la constante dans le type d’énumération spécifié associé à la valeur spécifiée.

public:
generic <typename TEnum>
 where TEnum : value class static System::String ^ GetName(TEnum value);

public static string? GetName<TEnum> (TEnum value) where TEnum : struct;

static member GetName : 'Enum -> string (requires 'Enum : struct)

Public Shared Function GetName(Of TEnum As Structure) (value As TEnum) As String

Paramètres de type

TEnum

Type de l'énumération.

Paramètres

value

TEnum

Valeur d’une constante énumérée qui a un type sous-jacent particulier.

Retours

String

Chaîne contenant le nom de la constante énumérée dans TEnum dont la valeur est value, ou null si aucune constante de ce type n'est trouvée.

Exceptions

InvalidOperationException

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