Enum.TryParse Метод

Исходный код:

Enum.cs

Исходный код:

Enum.cs

Исходный код:

Enum.cs

public:
 static bool TryParse(Type ^ enumType, ReadOnlySpan<char> value, [Runtime::InteropServices::Out] System::Object ^ % result);

public static bool TryParse (Type enumType, ReadOnlySpan<char> value, out object? result);

static member TryParse : Type * ReadOnlySpan<char> * obj -> bool

Public Shared Function TryParse (enumType As Type, value As ReadOnlySpan(Of Char), ByRef result As Object) As Boolean

Параметры

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

true, если преобразование выполнено успешно; false в противном случае.

Исключения

Исходный код:

Enum.cs

Исходный код:

Enum.cs

Исходный код:

Enum.cs

public:
 static bool TryParse(Type ^ enumType, System::String ^ value, [Runtime::InteropServices::Out] System::Object ^ % result);

public static bool TryParse (Type enumType, string? value, out object? result);

public static bool TryParse (Type enumType, string value, out object result);

static member TryParse : Type * string * obj -> bool

Public Shared Function TryParse (enumType As Type, value As String, ByRef result As Object) As Boolean

Параметры

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

true, если преобразование выполнено успешно; false в противном случае.

Исключения

Исходный код:

Enum.cs

Исходный код:

Enum.cs

Исходный код:

Enum.cs

public:
 static bool TryParse(Type ^ enumType, ReadOnlySpan<char> value, bool ignoreCase, [Runtime::InteropServices::Out] System::Object ^ % result);

public static bool TryParse (Type enumType, ReadOnlySpan<char> value, bool ignoreCase, out object? result);

static member TryParse : Type * ReadOnlySpan<char> * bool * obj -> bool

Public Shared Function TryParse (enumType As Type, value As ReadOnlySpan(Of Char), ignoreCase As Boolean, ByRef result As Object) As Boolean

Параметры

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

true, если преобразование выполнено успешно; false в противном случае.

Исключения

Исходный код:

Enum.cs

Исходный код:

Enum.cs

Исходный код:

Enum.cs

public:
 static bool TryParse(Type ^ enumType, System::String ^ value, bool ignoreCase, [Runtime::InteropServices::Out] System::Object ^ % result);

public static bool TryParse (Type enumType, string? value, bool ignoreCase, out object? result);

public static bool TryParse (Type enumType, string value, bool ignoreCase, out object result);

static member TryParse : Type * string * bool * obj -> bool

Public Shared Function TryParse (enumType As Type, value As String, ignoreCase As Boolean, ByRef result As Object) As Boolean

Параметры

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

true, если преобразование выполнено успешно; false в противном случае.

Исключения

Исходный код:

Enum.cs

Исходный код:

Enum.cs

Исходный код:

Enum.cs

public:
generic <typename TEnum>
 where TEnum : value class static bool TryParse(ReadOnlySpan<char> value, [Runtime::InteropServices::Out] TEnum % result);

public static bool TryParse<TEnum> (ReadOnlySpan<char> value, out TEnum result) where TEnum : struct;

static member TryParse : ReadOnlySpan<char> * 'Enum -> bool (requires 'Enum : struct)

Public Shared Function TryParse(Of TEnum As Structure) (value As ReadOnlySpan(Of Char), ByRef result As TEnum) As Boolean

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

Параметры

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

true, если преобразование выполнено успешно; false в противном случае.

Исключения

Исходный код:

Enum.cs

Исходный код:

Enum.cs

Исходный код:

Enum.cs

public:
generic <typename TEnum>
 where TEnum : value class static bool TryParse(System::String ^ value, [Runtime::InteropServices::Out] TEnum % result);

public static bool TryParse<TEnum> (string value, out TEnum result) where TEnum : struct;

public static bool TryParse<TEnum> (string? value, out TEnum result) where TEnum : struct;

static member TryParse : string * 'Enum -> bool (requires 'Enum : struct)

Public Shared Function TryParse(Of TEnum As Structure) (value As String, ByRef result As TEnum) As Boolean

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

Параметры

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

true, если параметр value был успешно преобразован; в противном случае false.

Исключения

Примеры

В следующем примере определяется перечисление Colors, вызывается метод TryParse<TEnum>(String, TEnum) для преобразования строк в соответствующие значения перечисления и вызывает метод 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)
      {
         Colors colorValue;
         if (Enum.TryParse(colorString, out colorValue))
            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);
         else
            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
    match Enum.TryParse colorString with
    | true, colorValue ->
        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."
    | _ ->
        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
         Dim colorValue As Colors
         If [Enum].TryParse(colorString, colorValue) Then        
            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                    
         Else
            Console.WriteLine("{0} is not a member of the Colors enumeration.", colorString)
         End If
      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.

Комментарии

TryParse<TEnum>(String, TEnum) идентичен методу Parse(Type, String), за исключением того, что вместо создания исключения он возвращает false, если преобразование завершается ошибкой. Это устраняет необходимость обработки исключений при анализе строкового представления значения перечисления.

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

Если value — это имя, которое не соответствует именованной константе TEnum, метод возвращает false. Если value представляет строковое представление целочисленного числа, которое не представляет базовое значение перечисления TEnum, метод возвращает элемент перечисления, базовый значение которого value преобразовано в целочисленный тип. Если это поведение нежелательно, вызовите метод IsDefined, чтобы убедиться, что определенное строковое представление целого числа фактически является членом TEnum.

Если операция синтаксического анализа завершается ошибкой, параметр result содержит значение по умолчанию 0, которое может не быть членом базового перечисления TEnum. Если именованные константы в TEnumне назначены, значение по умолчанию равно первому элементу TEnum. В противном случае значение по умолчанию равно члену перечисления с назначенным значением 0.

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

• Parse(Type, String)

Исходный код:

Enum.cs

Исходный код:

Enum.cs

Исходный код:

Enum.cs

public:
generic <typename TEnum>
 where TEnum : value class static bool TryParse(System::String ^ value, bool ignoreCase, [Runtime::InteropServices::Out] TEnum % result);

public static bool TryParse<TEnum> (string value, bool ignoreCase, out TEnum result) where TEnum : struct;

public static bool TryParse<TEnum> (string? value, bool ignoreCase, out TEnum result) where TEnum : struct;

static member TryParse : string * bool * 'Enum -> bool (requires 'Enum : struct)

Public Shared Function TryParse(Of TEnum As Structure) (value As String, ignoreCase As Boolean, ByRef result As TEnum) As Boolean

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

Параметры

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

true, если параметр value был успешно преобразован; в противном случае false.

Исключения

Примеры

В следующем примере определяется перечисление Colors, вызывается метод TryParse<TEnum>(String, Boolean, TEnum) для преобразования строк в соответствующие значения перечисления и вызывает метод IsDefined, чтобы гарантировать, что определенные целочисленные значения являются базовыми значениями в перечислении Colors. Метод TryParse<TEnum>(String, Boolean, TEnum) использует сравнение без учета регистра при попытке преобразовать строковые представления именованных констант в эквивалентные значения перечисления.

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)
      {
         Colors colorValue;
         if (Enum.TryParse(colorString, true, out colorValue))
            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);
         else
            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
    match Enum.TryParse(colorString, true) with
    | true, colorValue ->
        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."
    | _ ->
        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
         Dim colorValue As Colors
         If [Enum].TryParse(colorString, True, colorValue) Then        
            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                    
         Else
            Console.WriteLine("{0} is not a member of the Colors enumeration.", colorString)
         End If
      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.

Комментарии

TryParse<TEnum>(String, Boolean, TEnum) идентичен методу Parse(Type, String, Boolean), за исключением того, что вместо создания исключения он возвращает false, если преобразование завершается ошибкой. Это устраняет необходимость обработки исключений при анализе строкового представления значения перечисления.

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

Если value — это имя, которое не соответствует именованной константе TEnum, метод возвращает false. Если value представляет строковое представление целочисленного числа, которое не представляет базовое значение перечисления TEnum, метод возвращает элемент перечисления, базовый значение которого value преобразовано в целочисленный тип. Если это поведение нежелательно, вызовите метод IsDefined, чтобы убедиться, что определенное строковое представление целого числа фактически является членом TEnum.

Если операция синтаксического анализа завершается ошибкой, параметр result содержит значение по умолчанию 0, которое может не быть членом базового перечисления TEnum. Если именованные константы в TEnumне назначены, значение по умолчанию равно первому элементу TEnum. В противном случае значение по умолчанию равно члену перечисления с назначенным значением 0.

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

• Parse(Type, String, Boolean)

Исходный код:

Enum.cs

Исходный код:

Enum.cs

Исходный код:

Enum.cs

public:
generic <typename TEnum>
 where TEnum : value class static bool TryParse(ReadOnlySpan<char> value, bool ignoreCase, [Runtime::InteropServices::Out] TEnum % result);

public static bool TryParse<TEnum> (ReadOnlySpan<char> value, bool ignoreCase, out TEnum result) where TEnum : struct;

static member TryParse : ReadOnlySpan<char> * bool * 'Enum -> bool (requires 'Enum : struct)

Public Shared Function TryParse(Of TEnum As Structure) (value As ReadOnlySpan(Of Char), ignoreCase As Boolean, ByRef result As TEnum) As Boolean

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

Параметры

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

true, если преобразование выполнено успешно; false в противном случае.

Исключения