Enum.GetName Metoda

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

Přetížení

Name	Description
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

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í výčtové konstanty z hlediska jeho základního typu.

Návraty

String

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

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ších verzích: enumType je logický typ výčtu.

Příklady

Následující příklad ilustruje použití GetName.

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 má více členů výčtu 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, když 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)

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í výčtové konstanty z hlediska jeho základního typu.

Návraty

String

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

Výjimky

InvalidOperationException

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