Enum.GetUnderlyingType(Type) Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Assembly:

netstandard.dll

Assembly:

mscorlib.dll

Retorna o tipo subjacente da enumeração especificada.

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

Parâmetros

enumType

Type

A enumeração cujo tipo subjacente será recuperada.

Retornos

Type

O tipo subjacente de enumType.

Atributos

ComVisibleAttribute

Exceções

ArgumentNullException

enumType é null.

ArgumentException

enumType não é um Enum.

Exemplos

O exemplo a seguir chama GetUnderlyingType o método para exibir o tipo subjacente de alguns membros de enumeração.

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

Comentários

A Enum estrutura permite que os valores sejam representados como constantes nomeadas. O tipo de dados dos valores da enumeração é conhecido como seu tipo subjacente. Por exemplo, o tipo subjacente da enumeração , que consiste em constantes que representam cada dia da semana DayOfWeek ( , e assim por DayOfWeek.Monday DayOfWeek.Tuesday diante), é Int32 .

Confira também

• GetTypeCode()