Enum.GetUnderlyingType(Type) Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Assembly:

netstandard.dll

Assembly:

mscorlib.dll

Retourne le type sous-jacent de l'énumération spécifiée.

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

Paramètres

enumType

Type

Énumération dont le type sous-jacent sera récupéré.

Retours

Type

Type sous-jacent de enumType.

Attributs

ComVisibleAttribute

Exceptions

ArgumentNullException

enumType est null.

ArgumentException

enumType n'est pas Enum.

Exemples

L’exemple suivant appelle la GetUnderlyingType méthode pour afficher le type sous-jacent de certains membres de l’énumération.

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

Remarques

La Enum structure permet aux valeurs d’être représentées en tant que constantes nommées. Le type de données des valeurs de l’énumération est connu sous le nom de son type sous-jacent. Par exemple, le type sous-jacent de l' DayOfWeek énumération, qui se compose de constantes représentant chaque jour de la semaine ( DayOfWeek.Monday , DayOfWeek.Tuesday , etc.), est Int32 .

Voir aussi

• GetTypeCode()