Enum.GetNames Metodo

Definizione

Overload

GetNames(Type)

Restituisce una matrice dei nomi delle costanti in una enumerazione specificata.

GetNames<TEnum>()

Recupera una matrice dei nomi delle costanti in un tipo di enumerazione specificato.

GetNames(Type)

Origine:
Enum.cs
Origine:
Enum.cs
Origine:
Enum.cs

Restituisce una matrice dei nomi delle costanti in una enumerazione specificata.

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

Parametri

enumType
Type

Tipo di enumerazione.

Restituisce

String[]

Matrice di stringhe dei nomi delle costanti in enumType.

Attributi

Eccezioni

enumType è null.

Il parametro enumType non è un oggetto Enum.

.NET 8 e versioni successive: enumType è un tipo di enumerazione con supporto booleano.

Esempio

Nell'esempio riportato di seguito viene illustrato l'utilizzo del metodo GetNames.

using System;

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

    public static void Main() {

        Console.WriteLine("The members of the Colors enum are:");
        foreach(string s in Enum.GetNames(typeof(Colors)))
            Console.WriteLine(s);

        Console.WriteLine();

        Console.WriteLine("The members of the Styles enum are:");
        foreach(string s in Enum.GetNames(typeof(Styles)))
            Console.WriteLine(s);
    }
}
// The example displays the following output:
//       The members of the Colors enum are:
//       Red
//       Green
//       Blue
//       Yellow
//
//       The members of the Styles enum are:
//       Plaid
//       Striped
//       Tartan
//       Corduroy

Commenti

Gli elementi della matrice di valori restituiti vengono ordinati in base ai valori binari delle costanti enumerate, ovvero in base alla loro grandezza senza segno. Nell'esempio seguente vengono visualizzate informazioni sulla matrice restituita dal GetNames metodo per un'enumerazione che include un valore negativo, zero e positivo.

using System;

enum SignMagnitude { Negative = -1, Zero = 0, Positive = 1 };

public class Example
{
   public static void Main()
   {
      foreach (var name in Enum.GetNames(typeof(SignMagnitude))) {
         Console.WriteLine("{0,3:D}     0x{0:X}     {1}",
                           Enum.Parse(typeof(SignMagnitude), name),
                           name);
}   }
}
// The example displays the following output:
//         0     0x00000000     Zero
//         1     0x00000001     Positive
//        -1     0xFFFFFFFF     Negative

Se sono presenti costanti enumerate con lo stesso valore, l'ordine dei nomi corrispondenti non viene specificato.

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

GetNames<TEnum>()

Origine:
Enum.cs
Origine:
Enum.cs
Origine:
Enum.cs

Recupera una matrice dei nomi delle costanti in un tipo di enumerazione specificato.

public static string[] GetNames<TEnum> () where TEnum : struct;

Parametri di tipo

TEnum

Tipo dell'enumerazione.

Restituisce

String[]

Matrice di stringhe dei nomi delle costanti in TEnum.

Eccezioni

.NET 8 e versioni successive: TEnum è un tipo di enumerazione con supporto booleano.

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET 5, 6, 7, 8, 9