Enum.GetName Methode

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Überlädt

GetName(Type, Object)	Ruft den Namen der Konstanten der angegebenen Enumeration mit dem angegebenen Wert ab.
GetName<TEnum>(TEnum)	Ruft den Namen der Konstanten im angegebenen Enumerationstyp mit dem angegebenen Wert ab.

GetName(Type, Object)

Quelle:

Enum.cs

Ruft den Namen der Konstanten der angegebenen Enumeration mit dem angegebenen Wert ab.

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

Parameter

enumType

Type

Ein Enumerationstyp.

value

Object

Der Wert einer bestimmten Enumerationskonstanten als deren zugrunde liegender Typ.

Gibt zurück

String

Eine Zeichenfolge mit dem Namen der Enumerationskonstanten aus enumType, die den Wert value hat, oder null, wenn eine solche Konstante nicht gefunden wurde.

Ausnahmen

ArgumentNullException

enumType oder value ist null.

ArgumentException

enumType ist keine Enum.

- oder -

value ist weder vom Typ enumType noch liegt ihm derselbe Typ wie enumType zugrunde.

InvalidOperationException

.NET 8 und höhere Versionen: enumType ist ein boolescher Enumerationstyp.

Beispiele

Im folgenden Beispiel wird die Verwendung von GetName veranschaulicht.

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

Hinweise

Wenn mehrere Enumerationsmember denselben zugrunde liegenden Wert aufweisen, garantiert die GetName Methode, dass sie den Namen eines dieser Enumerationsmember zurückgibt. Es wird jedoch nicht garantiert, dass immer der Name desselben Enumerationsmembers zurückgegeben wird. Wenn mehrere Enumerationsmember denselben Wert haben, sollte Ihr Anwendungscode daher nie von der Methode abhängen, die den Namen eines bestimmten Members zurückgibt.

GetName<TEnum>(TEnum)

Quelle:

Enum.cs

Ruft den Namen der Konstanten im angegebenen Enumerationstyp mit dem angegebenen Wert ab.

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

Typparameter

TEnum

Der Typ der Enumeration.

Parameter

value

TEnum

Der Wert einer bestimmten Enumerationskonstanten als deren zugrunde liegender Typ.

Gibt zurück

String

Eine Zeichenfolge mit dem Namen der Enumerationskonstanten aus TEnum, die den Wert value hat, oder null, wenn eine solche Konstante nicht gefunden wurde.

Ausnahmen

InvalidOperationException

.NET 8 und höhere Versionen: TEnum ist ein boolescher Enumerationstyp.