Enum.TryParse 메서드

정의

네임스페이스:: System

어셈블리:: netstandard.dll, System.Runtime.dll

어셈블리:: System.Runtime.dll

어셈블리:: netstandard.dll

어셈블리:: mscorlib.dll, System.Runtime.dll

어셈블리:: mscorlib.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

하나 이상의 열거형 상수의 이름 또는 숫자 값의 문자열 표현을 해당하는 열거형 개체로 변환합니다. 반환 값은 변환이 성공했는지 여부를 나타냅니다.

오버로드

Name	Description
TryParse(Type, ReadOnlySpan<Char>, Object)	하나 이상의 열거형 상수의 이름 또는 숫자 값의 문자 표현 범위를 해당하는 열거형 개체로 변환합니다.
TryParse(Type, String, Object)	하나 이상의 열거형 상수의 이름 또는 숫자 값의 문자열 표현을 해당하는 열거형 개체로 변환합니다.
TryParse(Type, ReadOnlySpan<Char>, Boolean, Object)	하나 이상의 열거형 상수의 이름 또는 숫자 값의 문자 표현 범위를 해당하는 열거형 개체로 변환합니다. 매개 변수는 작업이 대/소문자를 구분하지 않는지 여부를 지정합니다.
TryParse(Type, String, Boolean, Object)	하나 이상의 열거형 상수의 이름 또는 숫자 값의 문자열 표현을 해당하는 열거형 개체로 변환합니다.
TryParse<TEnum>(ReadOnlySpan<Char>, TEnum)	하나 이상의 열거형 상수의 이름 또는 숫자 값의 문자열 표현을 해당하는 열거형 개체로 변환합니다.
TryParse<TEnum>(String, TEnum)	하나 이상의 열거형 상수의 이름 또는 숫자 값의 문자열 표현을 해당하는 열거형 개체로 변환합니다. 반환 값은 변환이 성공했는지 여부를 나타냅니다.
TryParse<TEnum>(String, Boolean, TEnum)	하나 이상의 열거형 상수의 이름 또는 숫자 값의 문자열 표현을 해당하는 열거형 개체로 변환합니다. 매개 변수는 작업이 대/소문자를 구분하는지 여부를 지정합니다. 반환 값은 변환이 성공했는지 여부를 나타냅니다.
TryParse<TEnum>(ReadOnlySpan<Char>, Boolean, TEnum)	하나 이상의 열거형 상수의 이름 또는 숫자 값의 문자열 표현을 해당하는 열거형 개체로 변환합니다. 매개 변수는 작업이 대/소문자를 구분하는지 여부를 지정합니다. 반환 값은 변환이 성공했는지 여부를 나타냅니다.

TryParse(Type, ReadOnlySpan<Char>, Object)

Source:: Enum.cs

Source:: Enum.cs

Source:: Enum.cs

Source:: Enum.cs

Source:: 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

매개 변수

enumType: Type

구문 분석에 사용할 열거형 형식입니다.

value: ReadOnlySpan<Char>

하나 이상의 열거형 상수의 이름 또는 숫자 값의 범위 표현입니다.

result: Object

이 메서드가 반환 true될 때 구문 분석된 값을 나타내는 열거형 상수가 포함됩니다.

반품

Boolean

변환에 성공하면 이고, 그렇지 않으면.

예외

InvalidOperationException

.NET 8 이상 버전: enumType 부울 지원 열거형 형식입니다.

적용 대상

TryParse(Type, String, Object)

Source:: Enum.cs

Source:: Enum.cs

Source:: Enum.cs

Source:: Enum.cs

Source:: 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

매개 변수

enumType: Type

구문 분석에 사용할 열거형 형식입니다.

value: String

하나 이상의 열거형 상수의 이름 또는 숫자 값의 문자열 표현입니다.

result: Object

이 메서드가 반환 true될 때 구문 분석된 값을 나타내는 열거형 상수가 포함됩니다.

반품

Boolean

변환에 성공하면 이고, 그렇지 않으면.

예외

InvalidOperationException

.NET 8 이상 버전: enumType 부울 지원 열거형 형식입니다.

적용 대상

TryParse(Type, ReadOnlySpan<Char>, Boolean, Object)

Source:: Enum.cs

Source:: Enum.cs

Source:: Enum.cs

Source:: Enum.cs

Source:: 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

매개 변수

enumType: Type

구문 분석에 사용할 열거형 형식입니다.

value: ReadOnlySpan<Char>

하나 이상의 열거형 상수의 이름 또는 숫자 값의 범위 표현입니다.

ignoreCase: Boolean

true대/소문자를 구분하지 않는 모드 enumType 에서 읽 false 는 경우, 대/소문자 구분 모드에서 읽 enumType 습니다.

result: Object

이 메서드가 반환 true될 때 구문 분석된 값을 나타내는 열거형 상수가 포함됩니다.

반품

Boolean

변환에 성공하면 이고, 그렇지 않으면.

예외

InvalidOperationException

.NET 8 이상 버전: enumType 부울 지원 열거형 형식입니다.

적용 대상

TryParse(Type, String, Boolean, Object)

Source:: Enum.cs

Source:: Enum.cs

Source:: Enum.cs

Source:: Enum.cs

Source:: 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

매개 변수

enumType: Type

구문 분석에 사용할 열거형 형식입니다.

value: String

하나 이상의 열거형 상수의 이름 또는 숫자 값의 문자열 표현입니다.

ignoreCase: Boolean

true대/소문자를 구분하지 않는 모드 value 에서 읽 false 는 경우, 대/소문자 구분 모드에서 읽 value 습니다.

result: Object

이 메서드가 반환 true될 때 구문 분석된 값을 나타내는 열거형 상수가 포함됩니다.

반품

Boolean

변환에 성공하면 이고, 그렇지 않으면.

예외

InvalidOperationException

.NET 8 이상 버전: enumType 부울 지원 열거형 형식입니다.

적용 대상

TryParse<TEnum>(ReadOnlySpan<Char>, TEnum)

Source:: Enum.cs

Source:: Enum.cs

Source:: Enum.cs

Source:: Enum.cs

Source:: 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

형식 매개 변수

TEnum

개체의 result 형식입니다.

매개 변수

value: ReadOnlySpan<Char>

하나 이상의 열거형 상수의 이름 또는 숫자 값의 범위 표현입니다.

result: TEnum

이 메서드가 반환 true될 때 구문 분석된 값을 나타내는 열거형 상수가 포함됩니다.

반품

Boolean

변환에 성공하면 이고, 그렇지 않으면.

예외

ArgumentException

TEnum 가 열거형 형식이 아닌 경우

InvalidOperationException

.NET 8 이상 버전: TEnum 부울 지원 열거형 형식입니다.

적용 대상

TryParse<TEnum>(String, TEnum)

Source:: Enum.cs

Source:: Enum.cs

Source:: Enum.cs

Source:: Enum.cs

Source:: 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

형식 매개 변수

TEnum

변환 value할 열거형 형식입니다.

매개 변수

value: String

변환할 열거형 이름 또는 기본 값의 대/소문자를 구분하는 문자열 표현입니다.

result: TEnum

이 메서드가 반환될 때 구문 분석 작업이 성공하면 값이 표시되는 TEnum 형식 value 의 개체를 포함합니다. 구문 분석 작업이 실패하는 경우 기본 형식 TEnum의 기본값을 포함합니다. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다.

반품

Boolean

매개 변수가 성공적으로 변환되었으면 이고, 그렇지 않으면 .

예외

ArgumentException

TEnum 가 열거형 형식이 아닌 경우

InvalidOperationException

.NET 8 이상 버전: TEnum 부울 지원 열거형 형식입니다.

예제

다음 예제에서는 열거형을 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) throw하는 대신 변환이 실패하면 반환 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)

적용 대상

TryParse<TEnum>(String, Boolean, TEnum)

Source:: Enum.cs

Source:: Enum.cs

Source:: Enum.cs

Source:: Enum.cs

Source:: 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

형식 매개 변수

TEnum

변환 value할 열거형 형식입니다.

매개 변수

value: String

변환할 열거형 이름 또는 기본 값의 문자열 표현입니다.

ignoreCase: Boolean

true 대/소문자를 무시하려면 false 대/소문자를 고려합니다.

result: TEnum

반품

Boolean

매개 변수가 성공적으로 변환되었으면 이고, 그렇지 않으면 .

예외

ArgumentException

TEnum 가 열거형 형식이 아닌 경우

InvalidOperationException

.NET 8 이상 버전: TEnum 부울 지원 열거형 형식입니다.

예제

다음 예제에서는 열거형을 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) throw하는 대신 변환이 실패하면 반환 false 된다는 점을 제외하고 메서드와 동일합니다. 열거형 값의 문자열 표현을 구문 분석할 때 예외 처리가 필요하지 않습니다.

추가 정보

Parse(Type, String, Boolean)

적용 대상

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

Source:: Enum.cs

Source:: Enum.cs

Source:: Enum.cs

Source:: Enum.cs

Source:: 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

형식 매개 변수

TEnum

개체의 result 형식입니다.

매개 변수

value: ReadOnlySpan<Char>

하나 이상의 열거형 상수의 이름 또는 숫자 값의 범위 표현입니다.

ignoreCase: Boolean

true 대/소문자를 무시하려면 false 대/소문자를 고려합니다.

result: TEnum

이 메서드가 반환 true될 때 구문 분석된 값을 나타내는 열거형 상수가 포함됩니다.

반품

Boolean

변환에 성공하면 이고, 그렇지 않으면.

예외

ArgumentException

TEnum 가 열거형 형식이 아닌 경우

InvalidOperationException

.NET 8 이상 버전: TEnum 부울 지원 열거형 형식입니다.

적용 대상

피드백

이 페이지가 도움이 되었나요?