Enum.GetName Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
- Source:
- Enum.cs
- 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);
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)
- Source:
- Enum.cs
- Source:
- Enum.cs
- 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
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.