Enum.Parse Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Преобразует строковое представление имени или числового значения одной или нескольких перечисляемых констант в эквивалентный перечислимый объект.
Перегрузки
Parse(Type, ReadOnlySpan<Char>) |
Преобразует диапазон символов представления имени или числового значения одной или нескольких перечисленных констант в эквивалентный перечислимый объект. |
Parse(Type, String) |
Преобразует строковое представление имени или числового значения одной или нескольких перечисляемых констант в эквивалентный перечислимый объект. |
Parse(Type, ReadOnlySpan<Char>, Boolean) |
Преобразует диапазон символов представления имени или числового значения одной или нескольких перечисленных констант в эквивалентный перечислимый объект. Параметр указывает, не учитывается ли операция регистра. |
Parse(Type, String, Boolean) |
Преобразует строковое представление имени или числового значения одной или нескольких перечисляемых констант в эквивалентный перечислимый объект. Параметр указывает, не учитывается ли операция регистра. |
Parse<TEnum>(String, Boolean) |
Преобразует строковое представление имени или числового значения одной или нескольких перечисленных констант, указанных |
Parse<TEnum>(ReadOnlySpan<Char>, Boolean) |
Преобразует диапазон символов представления имени или числового значения одной или нескольких перечисленных констант, указанных |
Parse<TEnum>(ReadOnlySpan<Char>) |
Преобразует диапазон символов представления имени или числового значения одной или нескольких перечисленных констант, указанных |
Parse<TEnum>(String) |
Преобразует строковое представление имени или числового значения одной или нескольких перечисленных констант, указанных |
Parse(Type, ReadOnlySpan<Char>)
- Исходный код:
- Enum.cs
- Исходный код:
- Enum.cs
- Исходный код:
- Enum.cs
Преобразует диапазон символов представления имени или числового значения одной или нескольких перечисленных констант в эквивалентный перечислимый объект.
public:
static System::Object ^ Parse(Type ^ enumType, ReadOnlySpan<char> value);
public static object Parse (Type enumType, ReadOnlySpan<char> value);
static member Parse : Type * ReadOnlySpan<char> -> obj
Public Shared Function Parse (enumType As Type, value As ReadOnlySpan(Of Char)) As Object
Параметры
- enumType
- Type
Тип перечисления.
- value
- ReadOnlySpan<Char>
Диапазон, содержащий имя или значение для преобразования.
Возвращаемое значение
Объект типа enumType
, значение которого представлено value
.
Исключения
enumType
null
.
enumType
не является Enum.
value
является пустой строкой или содержит только пробелы.
value
— это имя, но не одно из именованных констант, определенных для перечисления.
value
находится за пределами диапазона базового типа enumType
.
.NET 8 и более поздних версий: enumType
является логическим типом перечисления.
Применяется к
Parse(Type, String)
- Исходный код:
- Enum.cs
- Исходный код:
- Enum.cs
- Исходный код:
- Enum.cs
Преобразует строковое представление имени или числового значения одной или нескольких перечисляемых констант в эквивалентный перечислимый объект.
public:
static System::Object ^ Parse(Type ^ enumType, System::String ^ value);
public static object Parse (Type enumType, string value);
[System.Runtime.InteropServices.ComVisible(true)]
public static object Parse (Type enumType, string value);
static member Parse : Type * string -> obj
[<System.Runtime.InteropServices.ComVisible(true)>]
static member Parse : Type * string -> obj
Public Shared Function Parse (enumType As Type, value As String) As Object
Параметры
- enumType
- Type
Тип перечисления.
- value
- String
Строка, содержащая имя или значение для преобразования.
Возвращаемое значение
Объект типа enumType
, значение которого представлено value
.
- Атрибуты
Исключения
enumType
или value
null
.
enumType
не является Enum.
-или-
value
является пустой строкой или содержит только пробелы.
-или-
value
— это имя, но не одно из именованных констант, определенных для перечисления.
value
находится за пределами диапазона базового типа enumType
.
.NET 8 и более поздних версий: enumType
является логическим типом перечисления.
Примеры
В следующем примере метод Parse(Type, String) используется для анализа массива строк, созданных путем вызова метода GetNames. Он также использует метод Parse(Type, String) для анализа значения перечисления, состоящего из битового поля.
using namespace System;
[Flags]
enum class Colors
{
Red = 1,
Green = 2,
Blue = 4,
Yellow = 8
};
int main()
{
Console::WriteLine( "The entries of the Colors enumeration are:" );
Array^ a = Enum::GetNames( Colors::typeid );
Int32 i = 0;
while ( i < a->Length )
{
Object^ o = a->GetValue( i );
Console::WriteLine( o->ToString() );
i++;
}
Console::WriteLine();
Object^ orange = Enum::Parse( Colors::typeid, "Red, Yellow" );
Console::WriteLine("The orange value has the combined entries of {0}", orange );
}
/*
This code example produces the following results:
The entries of the Colors Enum are:
Red
Green
Blue
Yellow
The orange value has the combined entries of Red, Yellow
*/
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
*/
open System
[<Flags>]
type Colors =
| Red = 1
| Green = 2
| Blue = 4
| Yellow = 8
printfn "The entries of the Colors enumeration are:"
for colorName in Enum.GetNames typeof<Colors> do
printfn $"{colorName} = {Enum.Parse(typeof<Colors>, colorName):D}"
printfn ""
let orange = Enum.Parse(typeof<Colors>, "Red, Yellow") :?> Colors
printfn $"The orange value {orange:D} has the combined entries of {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
Public Class ParseTest
<Flags()> _
Enum Colors
Red = 1
Green = 2
Blue = 4
Yellow = 8
End Enum
Public Shared Sub Main()
Console.WriteLine("The entries of the Colors enumeration are:")
Dim colorName As String
For Each colorName In [Enum].GetNames(GetType(Colors))
Console.WriteLine("{0} = {1:D}", colorName, [Enum].Parse(GetType(Colors), colorName))
Next
Console.WriteLine()
Dim orange As Colors = CType([Enum].Parse(GetType(Colors), "Red, Yellow"), Colors)
Console.WriteLine("The orange value {0:D} has the combined entries of {0}", orange)
End Sub
End Class
'This example displays the following output:
'
'The entries of the Colors Enum are:
'Red = 1
'Green = 2
'Blue = 4
'Yellow = 8
'
'The myOrange 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
.
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.
open System
[<Flags>]
type Colors =
| None = 0
| Red = 1
| Green = 2
| Blue = 4
let colorStrings = [ "0"; "2"; "8"; "blue"; "Blue"; "Yellow"; "Red, Green" ]
for colorString in colorStrings do
try
let colorValue = Enum.Parse(typeof<Colors>, colorString) :?> Colors
if Enum.IsDefined(typeof<Colors>, colorValue) || (string colorValue).Contains "," then
printfn $"Converted '{colorString}' to {colorValue}."
else
printfn $"{colorString} is not an underlying value of the Colors enumeration."
with :? ArgumentException ->
printfn $"'{colorString}' is not a member of the Colors enumeration."
// 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.
<Flags> Enum Colors As Integer
None = 0
Red = 1
Green = 2
Blue = 4
End Enum
Module Example
Public Sub Main()
Dim colorStrings() As String = {"0", "2", "8", "blue", "Blue", "Yellow", "Red, Green"}
For Each colorString As String In colorStrings
Try
Dim colorValue As Colors = CType([Enum].Parse(GetType(Colors), colorString), Colors)
If [Enum].IsDefined(GetType(Colors), colorValue) Or colorValue.ToString().Contains(",") Then
Console.WriteLine("Converted '{0}' to {1}.", colorString, colorValue.ToString())
Else
Console.WriteLine("{0} is not an underlying value of the Colors enumeration.", colorString)
End If
Catch e As ArgumentException
Console.WriteLine("'{0}' is not a member of the Colors enumeration.", colorString)
End Try
Next
End Sub
End Module
' 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.
Эта операция учитывает регистр.
См. также раздел
Применяется к
Parse(Type, ReadOnlySpan<Char>, Boolean)
- Исходный код:
- Enum.cs
- Исходный код:
- Enum.cs
- Исходный код:
- Enum.cs
Преобразует диапазон символов представления имени или числового значения одной или нескольких перечисленных констант в эквивалентный перечислимый объект. Параметр указывает, не учитывается ли операция регистра.
public:
static System::Object ^ Parse(Type ^ enumType, ReadOnlySpan<char> value, bool ignoreCase);
public static object Parse (Type enumType, ReadOnlySpan<char> value, bool ignoreCase);
static member Parse : Type * ReadOnlySpan<char> * bool -> obj
Public Shared Function Parse (enumType As Type, value As ReadOnlySpan(Of Char), ignoreCase As Boolean) As Object
Параметры
- enumType
- Type
Тип перечисления.
- value
- ReadOnlySpan<Char>
Диапазон, содержащий имя или значение для преобразования.
- ignoreCase
- Boolean
true
игнорировать регистр; false
рассматривать дело.
Возвращаемое значение
Объект типа enumType
, значение которого представлено value
.
Исключения
enumType
null
.
enumType
не является Enum.
value
является пустой строкой или содержит только пробелы.
value
— это имя, но не одно из именованных констант, определенных для перечисления.
value
находится за пределами диапазона базового типа enumType
.NET 8 и более поздних версий: enumType
является логическим типом перечисления.
Применяется к
Parse(Type, String, Boolean)
- Исходный код:
- Enum.cs
- Исходный код:
- Enum.cs
- Исходный код:
- Enum.cs
Преобразует строковое представление имени или числового значения одной или нескольких перечисляемых констант в эквивалентный перечислимый объект. Параметр указывает, не учитывается ли операция регистра.
public:
static System::Object ^ Parse(Type ^ enumType, System::String ^ value, bool ignoreCase);
public static object Parse (Type enumType, string value, bool ignoreCase);
[System.Runtime.InteropServices.ComVisible(true)]
public static object Parse (Type enumType, string value, bool ignoreCase);
static member Parse : Type * string * bool -> obj
[<System.Runtime.InteropServices.ComVisible(true)>]
static member Parse : Type * string * bool -> obj
Public Shared Function Parse (enumType As Type, value As String, ignoreCase As Boolean) As Object
Параметры
- enumType
- Type
Тип перечисления.
- value
- String
Строка, содержащая имя или значение для преобразования.
- ignoreCase
- Boolean
true
игнорировать регистр; false
рассматривать дело.
Возвращаемое значение
Объект типа enumType
, значение которого представлено value
.
- Атрибуты
Исключения
enumType
или value
null
.
enumType
не является Enum.
-или-
value
является пустой строкой ("") или содержит только пробелы.
-или-
value
— это имя, но не одно из именованных констант, определенных для перечисления.
value
находится за пределами диапазона базового типа enumType
.
.NET 8 и более поздних версий: enumType
является логическим типом перечисления.
Примеры
В следующем примере метод Parse(Type, String, Boolean) используется для анализа массива строк, созданных путем вызова метода GetNames. Он также использует метод Parse(Type, String) для анализа значения перечисления, состоящего из битового поля.
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.
open System
[<Flags>]
type Colors =
| None = 0
| Red = 1
| Green = 2
| Blue = 4
let colorStrings = [ "0"; "2"; "8"; "blue"; "Blue"; "Yellow"; "Red, Green" ]
for colorString in colorStrings do
try
let colorValue = Enum.Parse(typeof<Colors>, colorString, true) :?> Colors
if Enum.IsDefined(typeof<Colors>, colorValue) || (string colorValue).Contains "," then
printfn $"Converted '{colorString}' to {colorValue}."
else
printfn $"{colorString} is not an underlying value of the Colors enumeration."
with :? ArgumentException ->
printfn $"{colorString} is not a member of the Colors enumeration."
// 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.
<Flags> Enum Colors As Integer
None = 0
Red = 1
Green = 2
Blue = 4
End Enum
Module Example
Public Sub Main()
Dim colorStrings() As String = {"0", "2", "8", "blue", "Blue", "Yellow", "Red, Green"}
For Each colorString As String In colorStrings
Try
Dim colorValue As Colors = CType([Enum].Parse(GetType(Colors), colorString, True), Colors)
If [Enum].IsDefined(GetType(Colors), colorValue) Or colorValue.ToString().Contains(",") Then
Console.WriteLine("Converted '{0}' to {1}.", colorString, colorValue.ToString())
Else
Console.WriteLine("{0} is not an underlying value of the Colors enumeration.", colorString)
End If
Catch e As ArgumentException
Console.WriteLine("{0} is not a member of the Colors enumeration.", colorString)
End Try
Next
End Sub
End Module
' 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
указывает, учитывает ли эта операция регистр.
См. также раздел
Применяется к
Parse<TEnum>(String, Boolean)
- Исходный код:
- Enum.cs
- Исходный код:
- Enum.cs
- Исходный код:
- Enum.cs
Преобразует строковое представление имени или числового значения одной или нескольких перечисленных констант, указанных TEnum
в эквивалентный перечислимый объект. Параметр указывает, не учитывается ли операция регистра.
public:
generic <typename TEnum>
where TEnum : value class static TEnum Parse(System::String ^ value, bool ignoreCase);
public static TEnum Parse<TEnum> (string value, bool ignoreCase) where TEnum : struct;
static member Parse : string * bool -> 'Enum (requires 'Enum : struct)
Public Shared Function Parse(Of TEnum As Structure) (value As String, ignoreCase As Boolean) As TEnum
Параметры типа
- TEnum
Тип перечисления.
Параметры
- value
- String
Строка, содержащая имя или значение для преобразования.
- ignoreCase
- Boolean
true
игнорировать регистр; false
рассматривать дело.
Возвращаемое значение
Объект типа TEnum
, значение которого представлено value
.
Исключения
TEnum
не является типом Enum.
value
null
.
value
не содержит сведений о перечислении.
.NET 8 и более поздних версий: TEnum
является логическим типом перечисления.
Применяется к
Parse<TEnum>(ReadOnlySpan<Char>, Boolean)
- Исходный код:
- Enum.cs
- Исходный код:
- Enum.cs
- Исходный код:
- Enum.cs
Преобразует диапазон символов представления имени или числового значения одной или нескольких перечисленных констант, указанных TEnum
в эквивалентный перечислимый объект. Параметр указывает, не учитывается ли операция регистра.
public:
generic <typename TEnum>
where TEnum : value class static TEnum Parse(ReadOnlySpan<char> value, bool ignoreCase);
public static TEnum Parse<TEnum> (ReadOnlySpan<char> value, bool ignoreCase) where TEnum : struct;
static member Parse : ReadOnlySpan<char> * bool -> 'Enum (requires 'Enum : struct)
Public Shared Function Parse(Of TEnum As Structure) (value As ReadOnlySpan(Of Char), ignoreCase As Boolean) As TEnum
Параметры типа
- TEnum
Тип перечисления.
Параметры
- value
- ReadOnlySpan<Char>
Диапазон, содержащий имя или значение для преобразования.
- ignoreCase
- Boolean
true
игнорировать регистр; false
рассматривать дело.
Возвращаемое значение
TEnum
Объект типа TEnum
, значение которого представлено value
.
Исключения
TEnum
не является типом Enum.
value
не содержит сведений о перечислении.
.NET 8 и более поздних версий: TEnum
является логическим типом перечисления.
Применяется к
Parse<TEnum>(ReadOnlySpan<Char>)
- Исходный код:
- Enum.cs
- Исходный код:
- Enum.cs
- Исходный код:
- Enum.cs
Преобразует диапазон символов представления имени или числового значения одной или нескольких перечисленных констант, указанных TEnum
в эквивалентный перечислимый объект.
public:
generic <typename TEnum>
where TEnum : value class static TEnum Parse(ReadOnlySpan<char> value);
public static TEnum Parse<TEnum> (ReadOnlySpan<char> value) where TEnum : struct;
static member Parse : ReadOnlySpan<char> -> 'Enum (requires 'Enum : struct)
Public Shared Function Parse(Of TEnum As Structure) (value As ReadOnlySpan(Of Char)) As TEnum
Параметры типа
- TEnum
Тип перечисления.
Параметры
- value
- ReadOnlySpan<Char>
Диапазон, содержащий имя или значение для преобразования.
Возвращаемое значение
TEnum
Объект типа TEnum
, значение которого представлено value
.
Исключения
TEnum
не является типом Enum.
value
не содержит сведений о перечислении.
.NET 8 и более поздних версий: TEnum
является логическим типом перечисления.
Применяется к
Parse<TEnum>(String)
- Исходный код:
- Enum.cs
- Исходный код:
- Enum.cs
- Исходный код:
- Enum.cs
Преобразует строковое представление имени или числового значения одной или нескольких перечисленных констант, указанных TEnum
в эквивалентный перечислимый объект.
public:
generic <typename TEnum>
where TEnum : value class static TEnum Parse(System::String ^ value);
public static TEnum Parse<TEnum> (string value) where TEnum : struct;
static member Parse : string -> 'Enum (requires 'Enum : struct)
Public Shared Function Parse(Of TEnum As Structure) (value As String) As TEnum
Параметры типа
- TEnum
Тип перечисления.
Параметры
- value
- String
Строка, содержащая имя или значение для преобразования.
Возвращаемое значение
Объект типа TEnum
, значение которого представлено value
.
Исключения
TEnum
не является типом Enum.
value
null
.
value
не содержит сведений о перечислении.
.NET 8 и более поздних версий: TEnum
является логическим типом перечисления.