Enum.GetNames Método

Definición

Espacio de nombres:

System

Ensamblados:

netstandard.dll, System.Runtime.dll

Sobrecargas

GetNames(Type)	Recupera una matriz con los nombres de las constantes de una enumeración especificada.
GetNames<TEnum>()	Recupera una matriz con los nombres de las constantes de un tipo de enumeración especificado.

GetNames(Type)

Source:

Enum.cs

Recupera una matriz con los nombres de las constantes de una enumeración especificada.

C#

public static string[] GetNames(Type enumType);

Parámetros

enumType

Type

Tipo de enumeración.

Devoluciones

String[]

Matriz de cadenas con los nombres de las constantes de enumType.

Excepciones

ArgumentNullException

enumType es null.

ArgumentException

El parámetro enumType no es un objeto Enum.

InvalidOperationException

.NET 8 y versiones posteriores: enumType es un tipo de enumeración con respaldo booleano.

Ejemplos

En el ejemplo siguiente se muestra el uso del método GetNames.

C#

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

Comentarios

Los elementos de la matriz de valores devueltos se ordenan por los valores binarios de las constantes enumeradas (es decir, por su magnitud sin signo). En el ejemplo siguiente se proporciona información sobre la matriz devuelta por el GetNames método para una enumeración que incluye un valor negativo, cero y positivo.

C#

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

Si hay constantes enumeradas con el mismo valor, no se especifica el orden de sus nombres correspondientes.

GetNames<TEnum>()

Source:

Enum.cs

Recupera una matriz con los nombres de las constantes de un tipo de enumeración especificado.

C#

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

Parámetros de tipo

TEnum

Tipo de la enumeración.

Devoluciones

String[]

Matriz de cadenas con los nombres de las constantes de TEnum.

Excepciones

InvalidOperationException

.NET 8 y versiones posteriores: TEnum es un tipo de enumeración con respaldo booleano.