Enum.GetName Methode

Definition

Überlädt

Name Beschreibung
GetName(Type, Object)

Ruft den Namen der Konstante in der angegebenen Aufzählung ab, die den angegebenen Wert aufweist.

GetName<TEnum>(TEnum)

Ruft den Namen der Konstante im angegebenen Enumerationstyp ab, der den angegebenen Wert aufweist.

GetName(Type, Object)

Quelle:
Enum.cs
Quelle:
Enum.cs
Quelle:
Enum.cs
Quelle:
Enum.cs
Quelle:
Enum.cs

Ruft den Namen der Konstante in der angegebenen Aufzählung ab, die den angegebenen Wert aufweist.

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

Parameter

enumType
Type

Ein Enumerationstyp.

value
Object

Der Wert einer bestimmten aufgezählten Konstante in Bezug auf den zugrunde liegenden Typ.

Gibt zurück

Eine Zeichenfolge, die den Namen der aufgezählten Konstante enthält, in enumType deren Wert value; oder null wenn keine solche Konstante gefunden wird.

Attribute

Ausnahmen

enumType oder value ist null.

enumType ist kein Enum.

-oder-

value ist weder vom Typ enumType noch hat sie denselben zugrunde liegenden Typ wie enumType.

.NET 8 und neueren Versionen: enumType ist ein boolescher Enumerationstyp.

Beispiele

Das folgende Beispiel veranschaulicht die Verwendung von 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

Hinweise

Wenn mehrere Enumerationsmermber denselben zugrunde liegenden Wert aufweisen, garantiert die GetName Methode, dass sie den Namen eines dieser Enumerationsmitglieder zurückgibt. Sie garantiert jedoch nicht, dass immer der Name desselben Enumerationselements zurückgegeben wird. Wenn mehrere Enumerationsmember denselben Wert aufweisen, sollte ihr Anwendungscode daher niemals von der Methode abhängen, die den Namen eines bestimmten Elements zurückgibt.

Gilt für:

GetName<TEnum>(TEnum)

Quelle:
Enum.cs
Quelle:
Enum.cs
Quelle:
Enum.cs
Quelle:
Enum.cs
Quelle:
Enum.cs

Ruft den Namen der Konstante im angegebenen Enumerationstyp ab, der den angegebenen Wert aufweist.

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 Aufzählung.

Parameter

value
TEnum

Der Wert einer bestimmten aufgezählten Konstante in Bezug auf den zugrunde liegenden Typ.

Gibt zurück

Eine Zeichenfolge, die den Namen der aufgezählten Konstante enthält, in TEnum deren Wert value; oder null wenn keine solche Konstante gefunden wird.

Ausnahmen

.NET 8 und neueren Versionen: TEnum ist ein boolescher Enumerationstyp.

Gilt für: