Enum.Parse Метод

Определение

Преобразует строковое представление имени или числового значения одной или нескольких перечисляемых констант в эквивалентный перечислимый объект.

Перегрузки

Parse(Type, ReadOnlySpan<Char>)

Преобразует диапазон символов представления имени или числового значения одной или нескольких перечисленных констант в эквивалентный перечислимый объект.

Parse(Type, String)

Преобразует строковое представление имени или числового значения одной или нескольких перечисляемых констант в эквивалентный перечислимый объект.

Parse(Type, ReadOnlySpan<Char>, Boolean)

Преобразует диапазон символов представления имени или числового значения одной или нескольких перечисленных констант в эквивалентный перечислимый объект. Параметр указывает, не учитывается ли операция регистра.

Parse(Type, String, Boolean)

Преобразует строковое представление имени или числового значения одной или нескольких перечисляемых констант в эквивалентный перечислимый объект. Параметр указывает, не учитывается ли операция регистра.

Parse<TEnum>(String, Boolean)

Преобразует строковое представление имени или числового значения одной или нескольких перечисленных констант, указанных TEnum в эквивалентный перечислимый объект. Параметр указывает, не учитывается ли операция регистра.

Parse<TEnum>(ReadOnlySpan<Char>, Boolean)

Преобразует диапазон символов представления имени или числового значения одной или нескольких перечисленных констант, указанных TEnum в эквивалентный перечислимый объект. Параметр указывает, не учитывается ли операция регистра.

Parse<TEnum>(ReadOnlySpan<Char>)

Преобразует диапазон символов представления имени или числового значения одной или нескольких перечисленных констант, указанных TEnum в эквивалентный перечислимый объект.

Parse<TEnum>(String)

Преобразует строковое представление имени или числового значения одной или нескольких перечисленных констант, указанных TEnum в эквивалентный перечислимый объект.

Parse(Type, ReadOnlySpan<Char>)

Исходный код:
Enum.cs
Исходный код:
Enum.cs
Исходный код:
Enum.cs

Преобразует диапазон символов представления имени или числового значения одной или нескольких перечисленных констант в эквивалентный перечислимый объект.

C#
public static object Parse (Type enumType, ReadOnlySpan<char> value);

Параметры

enumType
Type

Тип перечисления.

value
ReadOnlySpan<Char>

Диапазон, содержащий имя или значение для преобразования.

Возвращаемое значение

Объект типа enumType, значение которого представлено value.

Исключения

enumType null.

enumType не является Enum.

value является пустой строкой или содержит только пробелы.

value — это имя, но не одно из именованных констант, определенных для перечисления.

value находится за пределами диапазона базового типа enumType.

.NET 8 и более поздних версий: enumType является логическим типом перечисления.

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET 6, 7, 8, 9

Parse(Type, String)

Исходный код:
Enum.cs
Исходный код:
Enum.cs
Исходный код:
Enum.cs

Преобразует строковое представление имени или числового значения одной или нескольких перечисляемых констант в эквивалентный перечислимый объект.

C#
public static object Parse (Type enumType, string value);
C#
[System.Runtime.InteropServices.ComVisible(true)]
public static object Parse (Type enumType, string value);

Параметры

enumType
Type

Тип перечисления.

value
String

Строка, содержащая имя или значение для преобразования.

Возвращаемое значение

Объект типа enumType, значение которого представлено value.

Атрибуты

Исключения

enumType или valuenull.

enumType не является Enum.

-или-

value является пустой строкой или содержит только пробелы.

-или-

value — это имя, но не одно из именованных констант, определенных для перечисления.

value находится за пределами диапазона базового типа enumType.

.NET 8 и более поздних версий: enumType является логическим типом перечисления.

Примеры

В следующем примере метод Parse(Type, String) используется для анализа массива строк, созданных путем вызова метода GetNames. Он также использует метод Parse(Type, String) для анализа значения перечисления, состоящего из битового поля.

C#
using System;

public class ParseTest
{
    [Flags]
    enum Colors { Red = 1, Green = 2, Blue = 4, Yellow = 8 };

    public static void Main()
    {
        Console.WriteLine("The entries of the Colors enumeration are:");
        foreach (string colorName in Enum.GetNames(typeof(Colors)))
        {
            Console.WriteLine("{0} = {1:D}", colorName,
                                         Enum.Parse(typeof(Colors), colorName));
        }
        Console.WriteLine();

        Colors orange = (Colors) Enum.Parse(typeof(Colors), "Red, Yellow");
        Console.WriteLine("The orange value {0:D} has the combined entries of {0}",
                           orange);
    }
}

/*
This code example produces the following results:

The entries of the Colors Enum are:
Red = 1
Green = 2
Blue = 4
Yellow = 8

The orange value 9 has the combined entries of Red, Yellow

*/

Комментарии

Параметр value содержит строковое представление базового значения элемента перечисления или именованной константы или список именованных констант, разделенных запятыми (,). Одно или несколько пустых пробелов могут предшествовать каждому значению, имени или запятой в value. Если value является списком, возвращаемое значение является значением указанных имен в сочетании с побитовой OR операцией.

Если value — это имя, которое не соответствует именованной константе enumType, метод создает ArgumentException. Если value представляет строковое представление целочисленного числа, которое не представляет базовое значение перечисления enumType, метод возвращает элемент перечисления, базовый значение которого value преобразовано в целочисленный тип. Если это поведение нежелательно, вызовите метод IsDefined, чтобы убедиться, что определенное строковое представление целого числа фактически является членом enumType. В следующем примере определяется перечисление Colors, вызывается метод Parse(Type, String) для преобразования строк в соответствующие значения перечисления и вызывает метод IsDefined, чтобы гарантировать, что определенные целочисленные значения являются базовыми значениями в перечислении Colors.

C#
using System;

[Flags] enum Colors { None=0, Red = 1, Green = 2, Blue = 4 };

public class Example
{
   public static void Main()
   {
      string[] colorStrings = { "0", "2", "8", "blue", "Blue", "Yellow", "Red, Green" };
      foreach (string colorString in colorStrings)
      {
         try {
            Colors colorValue = (Colors) Enum.Parse(typeof(Colors), colorString);
            if (Enum.IsDefined(typeof(Colors), colorValue) | colorValue.ToString().Contains(","))
               Console.WriteLine("Converted '{0}' to {1}.", colorString, colorValue.ToString());
            else
               Console.WriteLine("{0} is not an underlying value of the Colors enumeration.", colorString);
         }
         catch (ArgumentException) {
            Console.WriteLine("'{0}' is not a member of the Colors enumeration.", colorString);
         }
      }
   }
}
// The example displays the following output:
//       Converted '0' to None.
//       Converted '2' to Green.
//       8 is not an underlying value of the Colors enumeration.
//       'blue' is not a member of the Colors enumeration.
//       Converted 'Blue' to Blue.
//       'Yellow' is not a member of the Colors enumeration.
//       Converted 'Red, Green' to Red, Green.

Эта операция учитывает регистр.

См. также раздел

Применяется к

.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

Parse(Type, ReadOnlySpan<Char>, Boolean)

Исходный код:
Enum.cs
Исходный код:
Enum.cs
Исходный код:
Enum.cs

Преобразует диапазон символов представления имени или числового значения одной или нескольких перечисленных констант в эквивалентный перечислимый объект. Параметр указывает, не учитывается ли операция регистра.

C#
public static object Parse (Type enumType, ReadOnlySpan<char> value, bool ignoreCase);

Параметры

enumType
Type

Тип перечисления.

value
ReadOnlySpan<Char>

Диапазон, содержащий имя или значение для преобразования.

ignoreCase
Boolean

true игнорировать регистр; false рассматривать дело.

Возвращаемое значение

Объект типа enumType, значение которого представлено value.

Исключения

enumType null.

enumType не является Enum.

value является пустой строкой или содержит только пробелы.

value — это имя, но не одно из именованных констант, определенных для перечисления.

value находится за пределами диапазона базового типа enumType

.NET 8 и более поздних версий: enumType является логическим типом перечисления.

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET 6, 7, 8, 9

Parse(Type, String, Boolean)

Исходный код:
Enum.cs
Исходный код:
Enum.cs
Исходный код:
Enum.cs

Преобразует строковое представление имени или числового значения одной или нескольких перечисляемых констант в эквивалентный перечислимый объект. Параметр указывает, не учитывается ли операция регистра.

C#
public static object Parse (Type enumType, string value, bool ignoreCase);
C#
[System.Runtime.InteropServices.ComVisible(true)]
public static object Parse (Type enumType, string value, bool ignoreCase);

Параметры

enumType
Type

Тип перечисления.

value
String

Строка, содержащая имя или значение для преобразования.

ignoreCase
Boolean

true игнорировать регистр; false рассматривать дело.

Возвращаемое значение

Объект типа enumType, значение которого представлено value.

Атрибуты

Исключения

enumType или valuenull.

enumType не является Enum.

-или-

value является пустой строкой ("") или содержит только пробелы.

-или-

value — это имя, но не одно из именованных констант, определенных для перечисления.

value находится за пределами диапазона базового типа enumType.

.NET 8 и более поздних версий: enumType является логическим типом перечисления.

Примеры

В следующем примере метод Parse(Type, String, Boolean) используется для анализа массива строк, созданных путем вызова метода GetNames. Он также использует метод Parse(Type, String) для анализа значения перечисления, состоящего из битового поля.

C#
using System;

[Flags] enum Colors { None=0, Red = 1, Green = 2, Blue = 4 };

public class Example
{
   public static void Main()
   {
      string[] colorStrings = { "0", "2", "8", "blue", "Blue", "Yellow", "Red, Green" };
      foreach (string colorString in colorStrings)
      {
         try {
            Colors colorValue = (Colors) Enum.Parse(typeof(Colors), colorString, true);
            if (Enum.IsDefined(typeof(Colors), colorValue) | colorValue.ToString().Contains(","))
               Console.WriteLine("Converted '{0}' to {1}.", colorString, colorValue.ToString());
            else
               Console.WriteLine("{0} is not an underlying value of the Colors enumeration.", colorString);
         }
         catch (ArgumentException) {
            Console.WriteLine("{0} is not a member of the Colors enumeration.", colorString);
         }
      }
   }
}
// The example displays the following output:
//       Converted '0' to None.
//       Converted '2' to Green.
//       8 is not an underlying value of the Colors enumeration.
//       Converted 'blue' to Blue.
//       Converted 'Blue' to Blue.
//       Yellow is not a member of the Colors enumeration.
//       Converted 'Red, Green' to Red, Green.

Комментарии

Параметр value содержит строковое представление базового значения элемента перечисления или именованной константы или список именованных констант, разделенных запятыми (,). Одно или несколько пустых пробелов могут предшествовать каждому значению, имени или запятой в value. Если value является списком, возвращаемое значение является значением указанных имен в сочетании с побитовой OR операцией.

Если value — это имя, которое не соответствует именованной константе enumType, метод создает ArgumentException. Если value представляет строковое представление целочисленного числа, которое не представляет базовое значение перечисления enumType, метод возвращает элемент перечисления, базовый значение которого value преобразовано в целочисленный тип. Если это поведение нежелательно, вызовите метод IsDefined, чтобы убедиться, что определенное строковое представление целого числа фактически является членом enumType. В следующем примере определяется перечисление Colors, вызывается метод Parse(Type, String, Boolean) для преобразования строк в соответствующие значения перечисления и вызывает метод IsDefined, чтобы гарантировать, что определенные целочисленные значения являются базовыми значениями в перечислении Colors.

Параметр ignoreCase указывает, учитывает ли эта операция регистр.

См. также раздел

Применяется к

.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

Parse<TEnum>(String, Boolean)

Исходный код:
Enum.cs
Исходный код:
Enum.cs
Исходный код:
Enum.cs

Преобразует строковое представление имени или числового значения одной или нескольких перечисленных констант, указанных TEnum в эквивалентный перечислимый объект. Параметр указывает, не учитывается ли операция регистра.

C#
public static TEnum Parse<TEnum> (string value, bool ignoreCase) where TEnum : struct;

Параметры типа

TEnum

Тип перечисления.

Параметры

value
String

Строка, содержащая имя или значение для преобразования.

ignoreCase
Boolean

true игнорировать регистр; false рассматривать дело.

Возвращаемое значение

TEnum

Объект типа TEnum, значение которого представлено value.

Исключения

TEnum не является типом Enum.

value null.

value не содержит сведений о перечислении.

.NET 8 и более поздних версий: TEnum является логическим типом перечисления.

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

Parse<TEnum>(ReadOnlySpan<Char>, Boolean)

Исходный код:
Enum.cs
Исходный код:
Enum.cs
Исходный код:
Enum.cs

Преобразует диапазон символов представления имени или числового значения одной или нескольких перечисленных констант, указанных TEnum в эквивалентный перечислимый объект. Параметр указывает, не учитывается ли операция регистра.

C#
public static TEnum Parse<TEnum> (ReadOnlySpan<char> value, bool ignoreCase) where TEnum : struct;

Параметры типа

TEnum

Тип перечисления.

Параметры

value
ReadOnlySpan<Char>

Диапазон, содержащий имя или значение для преобразования.

ignoreCase
Boolean

true игнорировать регистр; false рассматривать дело.

Возвращаемое значение

TEnum

TEnum Объект типа TEnum, значение которого представлено value.

Исключения

TEnum не является типом Enum.

value не содержит сведений о перечислении.

.NET 8 и более поздних версий: TEnum является логическим типом перечисления.

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET 6, 7, 8, 9

Parse<TEnum>(ReadOnlySpan<Char>)

Исходный код:
Enum.cs
Исходный код:
Enum.cs
Исходный код:
Enum.cs

Преобразует диапазон символов представления имени или числового значения одной или нескольких перечисленных констант, указанных TEnum в эквивалентный перечислимый объект.

C#
public static TEnum Parse<TEnum> (ReadOnlySpan<char> value) where TEnum : struct;

Параметры типа

TEnum

Тип перечисления.

Параметры

value
ReadOnlySpan<Char>

Диапазон, содержащий имя или значение для преобразования.

Возвращаемое значение

TEnum

TEnum Объект типа TEnum, значение которого представлено value.

Исключения

TEnum не является типом Enum.

value не содержит сведений о перечислении.

.NET 8 и более поздних версий: TEnum является логическим типом перечисления.

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET 6, 7, 8, 9

Parse<TEnum>(String)

Исходный код:
Enum.cs
Исходный код:
Enum.cs
Исходный код:
Enum.cs

Преобразует строковое представление имени или числового значения одной или нескольких перечисленных констант, указанных TEnum в эквивалентный перечислимый объект.

C#
public static TEnum Parse<TEnum> (string value) where TEnum : struct;

Параметры типа

TEnum

Тип перечисления.

Параметры

value
String

Строка, содержащая имя или значение для преобразования.

Возвращаемое значение

TEnum

Объект типа TEnum, значение которого представлено value.

Исключения

TEnum не является типом Enum.

value null.

value не содержит сведений о перечислении.

.NET 8 и более поздних версий: TEnum является логическим типом перечисления.

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1