Enum.GetUnderlyingType(Type) Methode

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Assembly:

netstandard.dll

Assembly:

mscorlib.dll

Gibt den zugrunde liegenden Typ der angegebenen Enumeration zurück.

public:
 static Type ^ GetUnderlyingType(Type ^ enumType);

public static Type GetUnderlyingType (Type enumType);

[System.Runtime.InteropServices.ComVisible(true)]
public static Type GetUnderlyingType (Type enumType);

static member GetUnderlyingType : Type -> Type

[<System.Runtime.InteropServices.ComVisible(true)>]
static member GetUnderlyingType : Type -> Type

Public Shared Function GetUnderlyingType (enumType As Type) As Type

Parameter

enumType

Type

Die Enumeration, deren zugrunde liegender Typ abgerufen wird.

Gibt zurück

Type

Der zugrunde liegende Typ von enumType.

Attribute

ComVisibleAttribute

Ausnahmen

ArgumentNullException

enumType ist null.

ArgumentException

enumType ist keine Enum.

Beispiele

Das folgende Beispiel ruft die GetUnderlyingType -Methode auf, um den zugrunde liegenden Typ einiger Enumerationsmember anzuzeigen.

using System;

public class Example
{
   public static void Main()
   {
      Enum[] enumValues = { ConsoleColor.Red, DayOfWeek.Monday,
                            MidpointRounding.ToEven, PlatformID.Win32NT,
                            DateTimeKind.Utc, StringComparison.Ordinal };
      Console.WriteLine("{0,-10} {1, 18}   {2,15}\n",
                        "Member", "Enumeration", "Underlying Type");
      foreach (var enumValue in enumValues)
         DisplayEnumInfo(enumValue);
   }

   static void DisplayEnumInfo(Enum enumValue)
   {
      Type enumType = enumValue.GetType();
      Type underlyingType = Enum.GetUnderlyingType(enumType);
      Console.WriteLine("{0,-10} {1, 18}   {2,15}",
                        enumValue, enumType.Name, underlyingType.Name);
   }
}
// The example displays the following output:
//       Member            Enumeration   Underlying Type
//
//       Red              ConsoleColor             Int32
//       Monday              DayOfWeek             Int32
//       ToEven       MidpointRounding             Int32
//       Win32NT            PlatformID             Int32
//       Utc              DateTimeKind             Int32
//       Ordinal      StringComparison             Int32

Module Example
   Public Sub Main()
      Dim enumValues() As [Enum] = { ConsoleColor.Red, DayOfWeek.Monday, 
                                     MidpointRounding.ToEven, PlatformID.Win32NT, 
                                     DateTimeKind.Utc, StringComparison.Ordinal }
      Console.WriteLine("{0,-10} {1, 18}   {2,15}", 
                        "Member", "Enumeration", "Underlying Type")
      Console.WriteLine()
      For Each enumValue In enumValues
         DisplayEnumInfo(enumValue)
      Next
   End Sub

   Sub DisplayEnumInfo(enumValue As [Enum])
      Dim enumType As Type = enumValue.GetType()
      Dim underlyingType As Type = [Enum].GetUnderlyingType(enumType)
      Console.WriteLine("{0,-10} {1, 18}   {2,15}",
                        enumValue, enumType.Name, underlyingType.Name)   
   End Sub
End Module
' The example displays the following output:
'       Member            Enumeration   Underlying Type
'       
'       Red              ConsoleColor             Int32
'       Monday              DayOfWeek             Int32
'       ToEven       MidpointRounding             Int32
'       Win32NT            PlatformID             Int32
'       Utc              DateTimeKind             Int32
'       Ordinal      StringComparison             Int32

Hinweise

Mit Enum der -Struktur können Werte als benannte Konstanten dargestellt werden. Der Datentyp der Enumerationswerte wird als zugrunde liegender Typ bezeichnet. Beispielsweise ist der zugrunde liegende Typ der DayOfWeek -Enumeration, der aus Konstanten besteht, die jeden Wochentag darstellen ( DayOfWeek.Monday DayOfWeek.Tuesday , usw.), Int32 .

Siehe auch

• GetTypeCode()