HOWTO · Csharp
C#에서 Int를 Enum으로 변환
캐스트나 파싱으로 정수를 C# enum으로 변환하고, 결과가 선언된 멤버인지 확인하는 방법을 배웁니다.
이 페이지의 내용
C#에서 정수를 열거형으로 변환하려면 열거형 형식으로 캐스팅합니다: MyEnum value = (MyEnum)number;. 열거형은 이름이 지정된 상수와 기반 정수 형식을 갖는 값 형식입니다. 캐스팅은 기반 값을 변환하지만, 그 값이 선언된 상수와 일치하는지는 확인하지 않습니다. 선언된 멤버만 허용하려면 Enum.IsDefined를 사용하고, 입력이 텍스트라면 Enum.Parse 또는 Enum.TryParse를 사용하세요.
정수를 직접 캐스팅해 열거형으로 변환하기
정수를 이미 가지고 있고 그 값도 직접 관리한다면 직접 캐스팅이 가장 간단합니다. 다음 완전한 예제에서는 기본 기반 형식인 int를 사용하는 열거형을 정의하고, 값 2를 캐스팅한 다음 해당 멤버 이름을 출력합니다. 변경할 수 없는 출력 블록의 레이블은 영어로 표시됩니다.
using System;
public class Program
{
public enum MyEnum { Zero = 0, One = 1, Two = 2 }
public static void Main()
{
int number = 2;
MyEnum value = (MyEnum)number;
Console.WriteLine($"Converted Enum Value: {value}");
}
}
캐스팅 자체는 결과를 검증하지 않습니다. 예를 들어 7을 캐스팅하면 MyEnum에 해당 값으로 선언된 멤버가 없어도 기반 값이 7인 열거형 값이 만들어집니다. 애플리케이션에서 선언된 멤버만 허용해야 한다면 캐스팅 전에 Enum.IsDefined로 확인하세요.
Enum.Parse로 정수 문자열 파싱하기
Enum.Parse는 문자열을 받습니다. 정수가 텍스트로 들어오면 그 문자열을 메서드에 전달하고, 반환된 object를 대상 열거형 형식으로 캐스팅합니다. 이 예제는 숫자 문자열 "1"을 파싱합니다. 변경할 수 없는 출력 블록의 레이블은 영어로 표시됩니다.
using System;
public class Program
{
public enum MyEnum { Zero = 0, One = 1, Two = 2 }
public static void Main()
{
string input = "1";
MyEnum value = (MyEnum)Enum.Parse(typeof(MyEnum), input);
Console.WriteLine($"Parsed Enum Value: {value}");
}
}
숫자 문자열을 파싱하면 기반 숫자에 해당하는 선언된 멤버가 없는 열거형 값이 만들어질 수도 있습니다. Enum.Parse는 형식이 잘못된 입력을 예외로 알립니다. 일반적인 변환 실패를 예외에 의존하는 제어 흐름 없이 처리하려면 Enum.TryParse를 사용하세요. 파싱에 성공했다는 사실만으로 해당 값이 선언된 멤버인지는 확인되지 않습니다.
Enum.IsDefined로 선언된 열거형 값인지 확인하기
값이 선언된 열거형 상수에 해당하는지 확인하려면 Enum.IsDefined를 사용합니다. 이 예제는 캐스팅 전에 선언된 정수 값과 선언되지 않은 값을 각각 확인합니다. MyEnum의 기본 기반 형식은 int이므로 박싱된 int 인수가 열거형의 기반 형식과 일치합니다. 변경할 수 없는 출력 블록의 레이블은 영어로 표시됩니다.
using System;
public class Program
{
public enum MyEnum { Zero = 0, One = 1, Two = 2 }
public static void Main()
{
int[] candidates = { 2, 7 };
foreach (int number in candidates)
{
if (Enum.IsDefined(typeof(MyEnum), number))
{
MyEnum value = (MyEnum)number;
Console.WriteLine($"{number}: defined as {value}");
}
else
{
Console.WriteLine($"{number}: not defined");
}
}
}
}
Enum.IsDefined는 정확히 선언된 상수 값과 일치하는지 확인합니다. 값이 각각 선언된 일반 열거형에는 적합하지만, [Flags] 열거형에서는 유효한 플래그 조합 자체가 선언되어 있지 않을 수 있습니다. 따라서 애플리케이션이 허용하려는 조합도 이 검사에서 거부될 수 있습니다.
Enum.TryParse로 정수 문자열 파싱하기
Enum.TryParse는 텍스트를 열거형 형식으로 변환할 수 있었는지를 Boolean 값으로 반환하고, 파싱된 값을 out 매개 변수에 씁니다. 입력으로 정수를 가지고 있다면 먼저 텍스트로 변환하세요. 이 예제는 숫자 파싱에 성공해도 해당 숫자가 선언된 멤버인지는 알 수 없으므로 멤버 여부를 별도로 확인합니다. 변경할 수 없는 출력 블록의 레이블은 영어로 표시됩니다.
using System;
public class Program
{
public enum MyEnum { Zero = 0, One = 1, Two = 2 }
public static void Main()
{
int number = 1;
string input = number.ToString();
if (Enum.TryParse<MyEnum>(input, out MyEnum value))
{
Console.WriteLine($"Parsed: {value}");
Console.WriteLine($"Declared: {Enum.IsDefined(typeof(MyEnum), value)}");
}
else
{
Console.WriteLine("Could not parse the input.");
}
}
}
이름을 입력하는 경우 Enum.TryParse는 "Two"처럼 선언된 멤버 이름도 받습니다. 숫자 텍스트는 선언되지 않은 기반 값으로도 파싱될 수 있으므로, 정확히 선언된 멤버가 필요한 애플리케이션에서는 Enum.IsDefined 검사도 유지하세요. 이름을 대소문자 구분 없이 일치시켜야 할 때만 ignoreCase 오버로드를 사용하세요.
상황에 맞는 변환 방법 선택하기
입력 형식과 필요한 검증 수준에 따라 방법을 선택하세요.
- 이미 신뢰할 수 있는 정수가 있고 선언되지 않은 열거형 값도 허용된다면 직접 캐스팅을 사용합니다.
- 텍스트 파싱 실패를 예외로 처리하려면
Enum.Parse를 사용합니다. - 텍스트 변환의 성공 여부를 Boolean 값으로 확인하려면
Enum.TryParse를 사용합니다. - 선언된 열거형 상수만 허용하려면 변환 전이나 후에
Enum.IsDefined를 사용합니다.
두 파싱 방법 모두 숫자 값이 선언된 상수에 해당한다고 보장하지 않습니다. 신뢰할 수 없거나 동적으로 들어오는 입력은 파싱을 시도한 뒤, 선언된 멤버만 허용하는 경우 Enum.IsDefined로 확인하세요. [Flags] 열거형에서는 Enum.IsDefined에만 의존하지 말고 허용할 조합에 대한 검증 규칙을 정해 적용하세요.