Enum.Format(Type, Object, String) 메서드

정의

네임스페이스:

System

어셈블리:

System.Runtime.dll

어셈블리:

mscorlib.dll

어셈블리:

netstandard.dll

열거 형식이 지정된 특정 값을 특정 서식에 따라 해당 문자열 표현으로 변환합니다.

public:
 static System::String ^ Format(Type ^ enumType, System::Object ^ value, System::String ^ format);

public static string Format (Type enumType, object value, string format);

[System.Runtime.InteropServices.ComVisible(true)]
public static string Format (Type enumType, object value, string format);

static member Format : Type * obj * string -> string

[<System.Runtime.InteropServices.ComVisible(true)>]
static member Format : Type * obj * string -> string

Public Shared Function Format (enumType As Type, value As Object, format As String) As String

매개 변수

enumType

Type

변환할 값의 열거형 형식입니다.

value

Object

변환할 값입니다.

format

String

사용할 출력 서식입니다.

반환

String

value의 문자열 표현입니다.

특성

ComVisibleAttribute

예외

ArgumentNullException

enumType, value 또는 format 매개 변수는 null입니다.

ArgumentException

enumType 매개 변수가 Enum 형식이 아닙니다.

또는

value는 enumType의 형식과 다른 열거형에서 얻은 것입니다.

또는

value의 형식은 enumType의 내부 형식이 아닙니다.

FormatException

format 매개 변수에 잘못된 값이 포함되어 있습니다.

InvalidOperationException

format이 "X"와 같지만 열거형 형식을 알 수 없습니다.

예제

다음 예제에서는 컨텍스트Enum에서의 Format 사용을 보여 줍니다.

using namespace System;
public enum class Colors
{
   Red, Green, Blue, Yellow
};

int main()
{
   Colors myColor = Colors::Blue;
   Console::WriteLine(  "My favorite color is {0}.", myColor );
   Console::WriteLine(  "The value of my favorite color is {0}.", Enum::Format( Colors::typeid, myColor,  "d" ) );
   Console::WriteLine(  "The hex value of my favorite color is {0}.", Enum::Format( Colors::typeid, myColor,  "x" ) );
}
// The example displays the folowing output:
//    My favorite color is Blue.
//    The value of my favorite color is 2.
//    The hex value of my favorite color is 00000002.

using System;

enum Colors { Red, Green, Blue, Yellow };

public class FormatTest {
    public static void Main() {
        Colors myColor = Colors.Blue;

        Console.WriteLine("My favorite color is {0}.", myColor);
        Console.WriteLine("The value of my favorite color is {0}.", Enum.Format(typeof(Colors), myColor, "d"));
        Console.WriteLine("The hex value of my favorite color is {0}.", Enum.Format(typeof(Colors), myColor, "x"));
    }
}
// The example displays the following output:
//    My favorite color is Blue.
//    The value of my favorite color is 2.
//    The hex value of my favorite color is 00000002.

open System

type Colors =
    | Red = 0
    | Green = 1
    | Blue = 2
    | Yellow = 3

let myColor = Colors.Blue

printfn $"My favorite color is {myColor}."
printfn $"""The value of my favorite color is {Enum.Format(typeof<Colors>, myColor, "d")}."""
printfn $"""The hex value of my favorite color is {Enum.Format(typeof<Colors>, myColor, "x")}."""
// The example displays the following output:
//    My favorite color is Blue.
//    The value of my favorite color is 2.
//    The hex value of my favorite color is 00000002.

 Enum Colors
     Red
     Green
     Blue
     Yellow    
 End Enum
    
Public Class FormatTest
    Public Shared Sub Main()
        Dim myColor As Colors = Colors.Blue
        
        Console.WriteLine("My favorite color is {0}.", myColor)
        Console.WriteLine("The value of my favorite color is {0}.", [Enum].Format(GetType(Colors), myColor, "d"))
        Console.WriteLine("The hex value of my favorite color is {0}.", [Enum].Format(GetType(Colors), myColor, "x"))
    End Sub 
End Class 
' The example displays the following output:
'    My favorite color is Blue.
'    The value of my favorite color is 2.
'    The hex value of my favorite color is 00000002.

설명

다음 표에서는 매개 변수에 대한 유효한 값을 보여 있습니다 format .

서식	설명
"G" 또는 "g"	명명된 열거형 상수와 같으면 value 해당 상수의 이름이 반환되고, 그렇지 않으면 10진 value 수가 반환됩니다. 예를 들어 열거형 상수만 Red이고 해당 값이 1이라고 가정합니다. 1로 지정되면 value 이 형식은 "Red"를 반환합니다. 그러나 2로 지정하면 value 이 형식은 "2"를 반환합니다. 또는 FlagsAttribute 사용자 지정 특성이 열거형 value 에 적용되는 경우 하나 이상의 비트로 구성된 하나 이상의 플래그가 포함된 비트 필드로 처리됩니다. 명명된 열거형 상수의 조합과 같으면 value 해당 상수의 이름에 대한 구분 기호로 구분된 목록이 반환됩니다. value 는 가장 큰 값을 가진 플래그에서 가장 작은 값으로 가는 플래그를 검색합니다. 의 비트 필드에 해당하는 각 플래그에 value대해 상수의 이름이 구분 기호로 구분된 목록에 연결됩니다. 그런 다음 해당 플래그의 값이 추가 고려 사항에서 제외되고 다음 플래그에 대한 검색이 계속됩니다. 명명된 열거형 상수의 조합과 같지 않으면 value 해당 10진 value 수가 반환됩니다.
"X" 또는 "x"	value 선행 "0x"가 없는 16진수 형식을 나타냅니다.
"D" 또는 "d"	value 10진수 형식을 나타냅니다.
"F" 또는 "f"	선언에 있을 필요가 없다는 점을 제외하고 FlagsAttribute "G" 또는 "g"에 Enum 동일하게 동작합니다.

추가 정보

• ToString(String)
• .NET의 서식 지정 형식
• 열거형 형식 문자열