Enum.GetName Méthode

Définition

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)

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);
public static string? GetName (Type enumType, object value);
[System.Runtime.InteropServices.ComVisible(true)]
public static string GetName (Type enumType, object value);
static member GetName : Type * obj -> string
[<System.Runtime.InteropServices.ComVisible(true)>]
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

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.

Attributs

Exceptions

enumType ou value est null.

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.

.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.

S’applique à

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.

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

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

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

S’applique à