Freigeben über


Enum.GetName-Methode

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

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
<ComVisibleAttribute(True)> _
Public Shared Function GetName ( _
    enumType As Type, _
    value As Object _
) As String
'Usage
Dim enumType As Type
Dim value As Object
Dim returnValue As String

returnValue = Enum.GetName(enumType, value)
[ComVisibleAttribute(true)] 
public static string GetName (
    Type enumType,
    Object value
)
[ComVisibleAttribute(true)] 
public:
static String^ GetName (
    Type^ enumType, 
    Object^ value
)
/** @attribute ComVisibleAttribute(true) */ 
public static String GetName (
    Type enumType, 
    Object value
)
ComVisibleAttribute(true) 
public static function GetName (
    enumType : Type, 
    value : Object
) : String

Parameter

  • enumType
    Ein Enumerationstyp.
  • value
    Der Wert einer bestimmten Enumerationskonstanten als deren zugrunde liegender Typ.

Rückgabewert

Eine Zeichenfolge mit dem Namen der Enumerationskonstanten aus enumType, die den Wert value hat, oder NULL (Nothing in Visual Basic), wenn eine solche Konstante nicht gefunden wurde.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentNullException

enumType oder value ist NULL (Nothing in Visual Basic).

ArgumentException

enumType ist keine Enum.

- oder -

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

Beispiel

Das folgende Codebeispiel veranschaulicht die Verwendung von GetName.

Imports System

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 'Main
End Class 'GetNameTest
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));
    }
}
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 ) );
}
import System.*;

public class GetNameTest
{
    enum Colors
    {
        red (0),
        green (1),
        blue (2),
        yellow (3);
    }//Colors

    enum Styles
    {
        plaid (0),
        striped (1),
        tartan (2),
        corduroy (3);
    }//Styles

    public static void main(String[] args)
    {
        Console.WriteLine("The 4th value of the Colors Enum is {0}", 
            Enum.GetName(Colors.class.ToType(), (Int32)3));
        Console.WriteLine("The 4th value of the Styles Enum is {0}", 
            Enum.GetName(Styles.class.ToType(), (Int32)3));
    } //main
} //GetNameTest
import System;

public class GetNameTest {
    enum Colors { Red, Green, Blue, Yellow };
    enum Styles { Plaid, Striped, Tartan, Corduroy };

    public static function Main() {

        Console.WriteLine("The 4th value of the Colors Enum is {0}", Enum.GetName(Colors, 3));
        Console.WriteLine("The 4th value of the Styles Enum is {0}", Enum.GetName(Styles, 3));
    }
}

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Enum-Struktur
Enum-Member
System-Namespace