Enum.GetNames 方法

定义

重载

GetNames(Type)

检索指定枚举中常数名称的数组。

GetNames<TEnum>()

检索指定枚举类型中常数名称的数组。

GetNames(Type)

Source:
Enum.cs
Source:
Enum.cs
Source:
Enum.cs

检索指定枚举中常数名称的数组。

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

参数

enumType
Type

枚举类型。

返回

String[]

enumType 的常数名称的字符串数组。

属性

例外

enumTypenull

enumType 参数不是 Enum

.NET 8 及更高版本: enumType 是一种布尔支持的枚举类型。

示例

下面的示例演示 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

注解

返回值数组的元素按枚举常量 (的二进制值排序,即按其无符号数量级) 排序。 下面的示例显示有关 方法为包含负值、零值和正值的枚举返回 GetNames 的数组的信息。

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

如果枚举常量具有相同的值,则未指定其相应名称的顺序。

适用于

.NET 9 和其他版本
产品 版本
.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>()

Source:
Enum.cs
Source:
Enum.cs
Source:
Enum.cs

检索指定枚举类型中常数名称的数组。

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

类型参数

TEnum

枚举的类型。

返回

String[]

TEnum 的常数名称的字符串数组。

例外

.NET 8 及更高版本: TEnum 是一种布尔支持的枚举类型。

适用于

.NET 9 和其他版本
产品 版本
.NET 5, 6, 7, 8, 9