Enum.GetUnderlyingType(Type) Methode

Definition

Gibt den zugrunde liegenden Typ der angegebenen Enumeration zurück.Returns the underlying type of the specified enumeration.

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.The enumeration whose underlying type will be retrieved.

Gibt zurück

Type

Der zugrunde liegende Typ von enumType.The underlying type of enumType.

Attribute

Ausnahmen

enumType ist null.enumType is null.

enumType ist keine Enum.enumType is not an Enum.

Beispiele

Im folgenden Beispiel wird die- GetUnderlyingType Methode aufgerufen, um den zugrunde liegenden Typ einiger Enumerationsmember anzuzeigen.The following example calls the GetUnderlyingType method to display the underlying type of some enumeration members.

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

Die- Enum Struktur ermöglicht die Darstellung von Werten als benannte Konstanten.The Enum structure enables values to be represented as named constants. Der Datentyp der Enumerationswerte wird als zugrunde liegender Typ bezeichnet.The data type of the enumeration's values is known as its underlying type. Beispielsweise ist der zugrunde liegende Typ der DayOfWeek Enumeration, der aus Konstanten besteht, die die einzelnen Wochentage darstellen ( DayOfWeek.Monday , DayOfWeek.Tuesday usw.), Int32 .For example, the underlying type of the DayOfWeek enumeration, which consists of constants that represent each day of the week (DayOfWeek.Monday, DayOfWeek.Tuesday, and so on), is Int32.

Gilt für:

Siehe auch