Enum.GetName Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ü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.