Enum.GetNames Método

Definição

Namespace:

System

Assemblies:

netstandard.dll, System.Runtime.dll

Sobrecargas

GetNames(Type)	Recupera uma matriz de nomes de constantes em uma enumeração especificada.
GetNames<TEnum>()	Recupera uma matriz de nomes de constantes em um tipo de enumeração especificado.

GetNames(Type)

Origem:

Enum.cs

Recupera uma matriz de nomes de constantes em uma enumeração especificada.

C#

public static string[] GetNames(Type enumType);

Parâmetros

enumType

Type

Um tipo de enumeração.

Retornos

String[]

Uma matriz de cadeia de caracteres dos nomes das constantes em enumType.

Exceções

ArgumentNullException

enumType é null.

ArgumentException

O parâmetro enumType não é um Enum.

InvalidOperationException

.NET 8 e versões posteriores: enumType é um tipo de enumeração com suporte booliano.

Exemplos

O exemplo a seguir ilustra o uso do 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

Comentários

Os elementos da matriz de valor retornado são classificados pelos valores binários das constantes enumeradas (ou seja, pela magnitude não assinada). O exemplo a seguir fornece informações sobre a matriz retornada pelo GetNames método para uma enumeração que inclui um valor negativo, zero e 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

Se houver constantes enumeradas com o mesmo valor, a ordem de seus nomes correspondentes não será especificada.

GetNames<TEnum>()

Origem:

Enum.cs

Recupera uma matriz de nomes de constantes em um tipo de enumeração especificado.

C#

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

Parâmetros de tipo

TEnum

O tipo da enumeração.

Retornos

String[]

Uma matriz de cadeia de caracteres dos nomes das constantes em TEnum.

Exceções

InvalidOperationException

.NET 8 e versões posteriores: TEnum é um tipo de enumeração com suporte booliano.