Enum.GetName Metoda

Definice

Obor názvů:

System

Sestavení:

System.Runtime.dll

Přetížení

GetName(Type, Object)	Načte název konstanty v zadaném výčtu, který má zadanou hodnotu.
GetName<TEnum>(TEnum)	Načte název konstanty v zadaném typu výčtu, který má zadanou hodnotu.

GetName(Type, Object)

Source:

Enum.cs

Načte název konstanty v zadaném výčtu, který má zadanou hodnotu.

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

Parametry

enumType

Type

Typ výčtu

value

Object

Hodnota konkrétní konstanty výčtu z hlediska jejího základního typu.

Návraty

String

Řetězec obsahující název vyčíslované konstanty, jejíž enumType hodnota je value; nebo null pokud se žádná taková konstanta nenajde.

Výjimky

ArgumentNullException

enumType nebo value je null.

ArgumentException

enumTypenení .Enum

-nebo-

value není typu enumType ani nemá stejný základní typ jako enumType.

InvalidOperationException

.NET 8 a novější verze: enumType je logický typ výčtu.

Příklady

Následující příklad znázorňuje použití nástroje 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

Poznámky

Pokud více členů výčtu má stejnou základní hodnotu, GetName metoda zaručuje, že vrátí název jednoho z těchto členů výčtu. Nezaručuje však, že vždy vrátí název stejného člena výčtu. V důsledku toho, pokud více členů výčtu má stejnou hodnotu, kód aplikace by nikdy neměl záviset na metodě vracející název konkrétního člena.

GetName<TEnum>(TEnum)

Source:

Enum.cs

Načte název konstanty v zadaném typu výčtu, který má zadanou hodnotu.

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

Parametry typu

TEnum

Typ výčtu.

Parametry

value

TEnum

Hodnota konkrétní konstanty výčtu z hlediska jejího základního typu.

Návraty

String

Řetězec obsahující název vyčíslované konstanty, jejíž TEnum hodnota je value; nebo null pokud se žádná taková konstanta nenajde.

Výjimky

InvalidOperationException

.NET 8 a novější verze: TEnum je logický typ výčtu.