Enum.ToString 메서드

정의

이 인스턴스의 값을 해당하는 문자열 표현으로 변환합니다.

오버로드

ToString()

이 인스턴스의 값을 해당하는 문자열 표현으로 변환합니다.

ToString(String, IFormatProvider)
사용되지 않습니다.
사용되지 않습니다.

이 메서드 오버로드는 더 이상 사용되지 않으므로 ToString(String)을 사용합니다.

ToString(String)

지정된 형식을 사용하여 이 인스턴스의 값을 해당하는 문자열 표현으로 변환합니다.

ToString(IFormatProvider)
사용되지 않습니다.
사용되지 않습니다.

이 메서드 오버로드는 더 이상 사용되지 않으므로 ToString()을 사용합니다.

ToString()

이 인스턴스의 값을 해당하는 문자열 표현으로 변환합니다.

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

반환

String

이 인스턴스 값의 문자열 표현입니다.

예제

다음 예제에서는 열거된 값을 문자열로 변환하는 방법을 보여 줍니다.

using namespace System;
public ref class EnumSample
{
public:
   enum class Colors
   {
      Red = 1,
      Blue = 2
   };

   static void main()
   {
      Enum ^ myColors = Colors::Red;
      Console::WriteLine( "The value of this instance is '{0}'", myColors );
   }

};

int main()
{
   EnumSample::main();
}

/*
Output.
The value of this instance is 'Red'.
*/
using System;

public class EnumSample {
    enum Colors {Red = 1, Blue = 2};

    public static void Main() {
        Enum myColors = Colors.Red;
        Console.WriteLine("The value of this instance is '{0}'",
           myColors.ToString());
    }
}
/*
Output.
The value of this instance is 'Red'.
*/
type Colors =
    | Red = 1
    | Blue = 2

let myColors = Colors.Red
printfn $"The value of this instance is '{myColors.ToString()}'"

// Output.
// The value of this instance is 'Red'.
Public Class EnumSample    
    Enum Colors
        Red = 1
        Blue = 2
    End Enum
    
    Public Shared Sub Main()
        Dim myColors As Colors = Colors.Red
        Console.WriteLine("The value of this instance is '{0}'", _
           myColors.ToString())
    End Sub
End Class

'Output.
'The value of this instance is 'Red'.

설명

반환 값은 일반 형식 지정자("G")로 서식이 지정됩니다. 즉, 이 열거형 형식에 적용되지 않고 이 인스턴스의 값과 같은 명명된 상수가 있는 경우 FlagsAttribute 반환 값은 상수의 이름을 포함하는 문자열입니다. FlagsAttribute 적용되고 이 인스턴스의 값과 같은 하나 이상의 명명된 상수 조합이 있는 경우 반환 값은 상수 이름의 구분 기호로 구분된 목록을 포함하는 문자열입니다. 그렇지 않으면 반환 값은 이 인스턴스의 숫자 값에 대한 문자열 표현입니다. 열거형 값의 서식 지정에 대한 자세한 내용은 열거형 형식 문자열을 참조하세요. 일반적인 서식 지정에 대한 자세한 내용은 형식 서식을 참조하세요.

호출자 참고

여러 열거형 멤버의 기본 값이 동일하고 기본 값을 기반으로 열거형 멤버 이름의 문자열 표현을 검색하려고 하면 코드에서 메서드가 반환할 이름을 가정해서는 안 됩니다. 예를 들어 다음 열거형은 기본 값이 같은 두 멤버인 Shade.GrayShade.Grey를 정의합니다.

enum Shade
{
    White = 0, Gray = 1, Grey = 1, Black = 2
}

다음 메서드 호출은 기본 값이 1인 셰이드 열거형의 멤버 이름을 검색하려고 시도합니다. 메서드는 "회색" 또는 "회색"을 반환할 수 있으며 코드는 반환될 문자열을 가정해서는 안 됩니다.

string shadeName = ((Shade) 1).ToString();

추가 정보

적용 대상

ToString(String, IFormatProvider)

주의

The provider argument is not used. Please use ToString(String).

주의

The provider argument is not used. Use ToString(String) instead.

이 메서드 오버로드는 더 이상 사용되지 않으므로 ToString(String)을 사용합니다.

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);
[System.Obsolete("The provider argument is not used. Please use ToString(String).")]
public string ToString (string? format, IFormatProvider? provider);
[System.Obsolete("The provider argument is not used. Use ToString(String) instead.")]
public string ToString (string? format, IFormatProvider? provider);
[System.Obsolete("The provider argument is not used. Please use ToString(String).")]
public string ToString (string format, IFormatProvider provider);
public string ToString (string format, IFormatProvider provider);
[<System.Obsolete("The provider argument is not used. Please use ToString(String).")>]
override this.ToString : string * IFormatProvider -> string
[<System.Obsolete("The provider argument is not used. Use ToString(String) instead.")>]
override this.ToString : string * IFormatProvider -> string
override this.ToString : string * IFormatProvider -> string
Public Function ToString (format As String, provider As IFormatProvider) As String

매개 변수

format
String

형식 사양입니다.

provider
IFormatProvider

이 항목은 사용되지 않습니다.

반환

String

이 인스턴스의 값을 format에 지정된 내용에 따라 나타낸 문자열 표현입니다.

구현

특성

예외

format에 올바른 형식 사양이 들어 있지 않습니다.

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

설명

매개 변수는 format "G" 또는 "g", "D" 또는 "d", "X" 또는 "x" 및 "F" 또는 "f" 형식 문자열 중 하나일 수 있습니다(형식 문자열은 대/소문자를 구분하지 않음). null 또는 빈 문자열("")인 경우 format 일반 형식 지정자("G")가 사용됩니다. 열거형 형식 문자열 및 서식 열거형 값에 대한 자세한 내용은 열거형 형식 문자열을 참조하세요. 일반적인 서식 지정에 대한 자세한 내용은 형식 서식 지정을 참조하세요.

format``provider 지정합니다. 매개 변수는 사용되지 않습니다.

추가 정보

적용 대상

ToString(String)

지정된 형식을 사용하여 이 인스턴스의 값을 해당하는 문자열 표현으로 변환합니다.

public:
 System::String ^ ToString(System::String ^ format);
public string ToString (string format);
public string ToString (string? format);
override this.ToString : string -> string
Public Function ToString (format As String) As String

매개 변수

format
String

서식 문자열입니다.

반환

String

이 인스턴스의 값을 format에 지정된 내용에 따라 나타낸 문자열 표현입니다.

예외

format에 잘못된 사양이 들어 있습니다.

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

예제

다음 예제에서는 열거형 값을 문자열로 변환하는 방법을 보여 줍니다.

// Sample for Enum::ToString(String)

using namespace System;

public enum class Colors
{
   Red, Green, Blue, Yellow = 12
};

int main()
{
   Colors myColor = Colors::Yellow;
   Console::WriteLine( "Colors::Red = {0}", Colors::Red.ToString( "d" ) );
   Console::WriteLine( "Colors::Green = {0}", Colors::Green.ToString( "d" ) );
   Console::WriteLine( "Colors::Blue = {0}", Colors::Blue.ToString( "d" ) );
   Console::WriteLine( "Colors::Yellow = {0}", Colors::Yellow.ToString( "d" ) );
   Console::WriteLine( " {0}myColor = Colors::Yellow {0}", Environment::NewLine );
   Console::WriteLine( "myColor->ToString(\"g\") = {0}", myColor.ToString( "g" ) );
   Console::WriteLine( "myColor->ToString(\"G\") = {0}", myColor.ToString( "G" ) );
   Console::WriteLine( "myColor->ToString(\"x\") = {0}", myColor.ToString( "x" ) );
   Console::WriteLine( "myColor->ToString(\"X\") = {0}", myColor.ToString( "X" ) );
   Console::WriteLine( "myColor->ToString(\"d\") = {0}", myColor.ToString( "d" ) );
   Console::WriteLine( "myColor->ToString(\"D\") = {0}", myColor.ToString( "D" ) );
   Console::WriteLine( "myColor->ToString(\"f\") = {0}", myColor.ToString( "f" ) );
   Console::WriteLine( "myColor->ToString(\"F\") = {0}", myColor.ToString( "F" ) );
}

/*
This example produces the following results:
Colors::Red = 0
Colors::Green = 1
Colors::Blue = 2
Colors::Yellow = 12

myColor = Colors::Yellow

myColor->ToString("g") = Yellow
myColor->ToString("G") = Yellow
myColor->ToString("x") = 0000000C
myColor->ToString("X") = 0000000C
myColor->ToString("d") = 12
myColor->ToString("D") = 12
myColor->ToString("f") = Yellow
myColor->ToString("F") = Yellow
*/
// Sample for Enum.ToString(String)
using System;

class Sample
{
    enum Colors {Red, Green, Blue, Yellow = 12};

    public static void Main()
    {
    Colors myColor = Colors.Yellow;

    Console.WriteLine("Colors.Red = {0}", Colors.Red.ToString("d"));
    Console.WriteLine("Colors.Green = {0}", Colors.Green.ToString("d"));
    Console.WriteLine("Colors.Blue = {0}", Colors.Blue.ToString("d"));
    Console.WriteLine("Colors.Yellow = {0}", Colors.Yellow.ToString("d"));

    Console.WriteLine("{0}myColor = Colors.Yellow{0}", Environment.NewLine);

    Console.WriteLine("myColor.ToString(\"g\") = {0}", myColor.ToString("g"));
    Console.WriteLine("myColor.ToString(\"G\") = {0}", myColor.ToString("G"));

    Console.WriteLine("myColor.ToString(\"x\") = {0}", myColor.ToString("x"));
    Console.WriteLine("myColor.ToString(\"X\") = {0}", myColor.ToString("X"));

    Console.WriteLine("myColor.ToString(\"d\") = {0}", myColor.ToString("d"));
    Console.WriteLine("myColor.ToString(\"D\") = {0}", myColor.ToString("D"));

    Console.WriteLine("myColor.ToString(\"f\") = {0}", myColor.ToString("f"));
    Console.WriteLine("myColor.ToString(\"F\") = {0}", myColor.ToString("F"));
    }
}
/*
This example produces the following results:
Colors.Red = 0
Colors.Green = 1
Colors.Blue = 2
Colors.Yellow = 12

myColor = Colors.Yellow

myColor.ToString("g") = Yellow
myColor.ToString("G") = Yellow
myColor.ToString("x") = 0000000C
myColor.ToString("X") = 0000000C
myColor.ToString("d") = 12
myColor.ToString("D") = 12
myColor.ToString("f") = Yellow
myColor.ToString("F") = Yellow
*/
// Sample for Enum.ToString(String)
open System

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

let myColor = Colors.Yellow

printfn $"""Colors.Red = {Colors.Red.ToString "d"}"""
printfn $"""Colors.Green = {Colors.Green.ToString "d"}"""
printfn $"""Colors.Blue = {Colors.Blue.ToString "d"}"""
printfn $"""Colors.Yellow = {Colors.Yellow.ToString "d"}"""

printfn "\nmyColor = Colors.Yellow\n"

printfn $"""myColor.ToString("g") = {myColor.ToString "g"}"""
printfn $"""myColor.ToString("G") = {myColor.ToString "G"}"""

printfn $"""myColor.ToString("x") = {myColor.ToString "x"}"""
printfn $"""myColor.ToString("X") = {myColor.ToString "X"}"""

printfn $"""myColor.ToString("d") = {myColor.ToString "d"}"""
printfn $"""myColor.ToString("D") = {myColor.ToString "d"}"""

printfn $"""myColor.ToString("f") = {myColor.ToString "f"}"""
printfn $"""myColor.ToString("F") = {myColor.ToString "F"}"""

// This example produces the following results:
//     Colors.Red = 0
//     Colors.Green = 1
//     Colors.Blue = 2
//     Colors.Yellow = 12
//    
//     myColor = Colors.Yellow
//    
//     myColor.ToString("g") = Yellow
//     myColor.ToString("G") = Yellow
//     myColor.ToString("x") = 0000000C
//     myColor.ToString("X") = 0000000C
//     myColor.ToString "d" = 12
//     myColor.ToString "d" = 12
//     myColor.ToString("f") = Yellow
//     myColor.ToString("F") = Yellow
' Sample for Enum.ToString(String)
Class Sample
   Enum Colors
      Red
      Green
      Blue
      Yellow = 12
   End Enum 'Colors
   
   Public Shared Sub Main()
      Dim myColor As Colors = Colors.Yellow
      
      Console.WriteLine("Colors.Red = {0}", Colors.Red.ToString("d"))
      Console.WriteLine("Colors.Green = {0}", Colors.Green.ToString("d"))
      Console.WriteLine("Colors.Blue = {0}", Colors.Blue.ToString("d"))
      Console.WriteLine("Colors.Yellow = {0}", Colors.Yellow.ToString("d"))
      
      Console.WriteLine("{0}myColor = Colors.Yellow{0}", Environment.NewLine)
      
      Console.WriteLine("myColor.ToString(""g"") = {0}", myColor.ToString("g"))
      Console.WriteLine("myColor.ToString(""G"") = {0}", myColor.ToString("G"))
      
      Console.WriteLine("myColor.ToString(""x"") = {0}", myColor.ToString("x"))
      Console.WriteLine("myColor.ToString(""X"") = {0}", myColor.ToString("X"))
      
      Console.WriteLine("myColor.ToString(""d"") = {0}", myColor.ToString("d"))
      Console.WriteLine("myColor.ToString(""D"") = {0}", myColor.ToString("D"))
      
      Console.WriteLine("myColor.ToString(""f"") = {0}", myColor.ToString("f"))
      Console.WriteLine("myColor.ToString(""F"") = {0}", myColor.ToString("F"))
   End Sub
End Class
'
'This example produces the following results:
'
'Colors.Red = 0
'Colors.Green = 1
'Colors.Blue = 2
'Colors.Yellow = 12
'
'myColor = Colors.Yellow
'
'myColor.ToString("g") = Yellow
'myColor.ToString("G") = Yellow
'myColor.ToString("x") = 0000000C
'myColor.ToString("X") = 0000000C
'myColor.ToString("d") = 12
'myColor.ToString("D") = 12
'myColor.ToString("f") = Yellow
'myColor.ToString("F") = Yellow
'

설명

매개 변수는 format "G" 또는 "g", "D" 또는 "d", "X" 또는 "x" 및 "F" 또는 "f" 형식 문자열 중 하나일 수 있습니다(형식 문자열은 대/소문자를 구분하지 않음). 이거나 null 빈 문자열("")인 경우 format 일반 형식 지정자("G")가 사용됩니다. 열거형 서식 문자열 및 서식 열거형 값에 대한 자세한 내용은 열거형 형식 문자열을 참조하세요. 일반적인 서식 지정에 대한 자세한 내용은 형식 서식을 참조하세요.

호출자 참고

여러 열거형 멤버의 기본 값이 동일하고 기본 값을 기반으로 열거형 멤버 이름의 문자열 표현을 검색하려고 하면 코드에서 메서드가 반환할 이름을 가정해서는 안 됩니다. 예를 들어 다음 열거형은 동일한 기본 값을 가진 두 멤버인 Shade.GrayShade.Grey를 정의합니다.

enum Shade
{
    White = 0, Gray = 1, Grey = 1, Black = 2
}

다음 메서드 호출은 기본 값이 1인 셰이드 열거형 멤버의 이름을 검색하려고 시도합니다. 메서드는 "회색" 또는 "회색"을 반환할 수 있으며 코드는 반환될 문자열을 가정해서는 안 됩니다.

string shadeName = ((Shade) 1).ToString("F");

추가 정보

적용 대상

ToString(IFormatProvider)

주의

The provider argument is not used. Please use ToString().

주의

The provider argument is not used. Use ToString() instead.

이 메서드 오버로드는 더 이상 사용되지 않으므로 ToString()을 사용합니다.

public:
 virtual System::String ^ ToString(IFormatProvider ^ provider);
[System.Obsolete("The provider argument is not used. Please use ToString().")]
public string ToString (IFormatProvider? provider);
[System.Obsolete("The provider argument is not used. Use ToString() instead.")]
public string ToString (IFormatProvider? provider);
[System.Obsolete("The provider argument is not used. Please use ToString().")]
public string ToString (IFormatProvider provider);
public string ToString (IFormatProvider provider);
[<System.Obsolete("The provider argument is not used. Please use ToString().")>]
override this.ToString : IFormatProvider -> string
[<System.Obsolete("The provider argument is not used. Use ToString() instead.")>]
override this.ToString : IFormatProvider -> string
override this.ToString : IFormatProvider -> string
Public Function ToString (provider As IFormatProvider) As String

매개 변수

provider
IFormatProvider

이 항목은 사용되지 않습니다.

반환

String

이 인스턴스 값의 문자열 표현입니다.

구현

특성

적용 대상