Enum.GetName Metoda

Reference

Definice

Obor názvů:: System

Sestavení:: mscorlib.dll, System.Runtime.dll

Sestavení:: netstandard.dll, System.Runtime.dll

Sestavení:: System.Runtime.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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)

Zdroj:: Enum.cs

Zdroj:: Enum.cs

Zdroj:: 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);

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

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.

Atributy: ComVisibleAttribute

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.

Platí pro

.NET 10 a další verze

Produkt	Verze
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

GetName<TEnum>(TEnum)

Zdroj:: Enum.cs

Zdroj:: Enum.cs

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

Platí pro

.NET 10 a další verze

Produkt	Verze
.NET	5, 6, 7, 8, 9, 10

Sdílet prostřednictvím

Enum.GetName Metoda

Definice

Přetížení

GetName(Type, Object)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Platí pro

GetName<TEnum>(TEnum)

Parametry typu

Parametry

Návraty

Výjimky

Platí pro

Další materiály