Enum.ToString Enum.ToString Enum.ToString Enum.ToString Method

정의

이 인스턴스의 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of this instance to its equivalent string representation.

오버로드

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

이 메서드 오버로드는 더 이상 사용되지 않으므로 ToString(String)을 사용합니다.This method overload is obsolete; use ToString(String).

ToString(String) ToString(String) ToString(String) ToString(String)

지정된 형식을 사용하여 이 인스턴스의 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of this instance to its equivalent string representation using the specified format.

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

이 메서드 오버로드는 더 이상 사용되지 않으므로 ToString()을 사용합니다.This method overload is obsolete; use ToString().

ToString() ToString() ToString() ToString()

이 인스턴스의 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of this instance to its equivalent string representation.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

경고

이 API는 현재 사용되지 않습니다.

이 메서드 오버로드는 더 이상 사용되지 않으므로 ToString(String)을 사용합니다.This method overload is obsolete; use 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);
override this.ToString : string * IFormatProvider -> string
Public Function ToString (format As String, provider As IFormatProvider) As String

매개 변수

format
String String String String

형식 사양입니다.A format specification.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

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

반환

이 인스턴스의 값을 format에 지정된 내용에 따라 나타낸 문자열 표현입니다.The string representation of the value of this instance as specified by format.

구현

예외

format에 올바른 형식 사양이 들어 있지 않습니다.format does not contain a valid format specification.

format이 "X"와 같지만 열거형 형식을 알 수 없습니다.format equals "X", but the enumeration type is unknown.

설명

format 매개 변수는 형식 문자열은 다음 중 하나일 수 있습니다. "G" 또는 "g", "D" 또는 "d", "X" 또는 "x" 및 "F" 또는 "f" (형식 문자열은 대/소문자 구분).The format parameter can be one of the following format strings: "G" or "g", "D" or "d", "X" or "x", and "F" or "f" (the format string is not case-sensitive). 하는 경우 formatnull 또는 빈 문자열 (""), 일반 형식 지정자 ("G")만 사용 합니다.If format is null or an empty string (""), the general format specifier ("G") is used. 열거형 형식 문자열 및 서식 지정 열거형 값에 대 한 자세한 내용은 참조 하세요. 열거형 형식 문자열합니다.For more information about the enumeration format strings and formatting enumeration values, see Enumeration Format Strings. 일반 형식 지정에 대 한 자세한 내용은 참조 하세요. 형식합니다.For more information about formatting in general, see Formatting Types.

만 지정한 formatprovider 매개 변수는 사용 되지 않습니다.Specify only format; the provider parameter is obsolete.

추가 정보

ToString(String) ToString(String) ToString(String) ToString(String)

지정된 형식을 사용하여 이 인스턴스의 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of this instance to its equivalent string representation using the specified format.

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

매개 변수

format
String String String String

서식 문자열입니다.A format string.

반환

이 인스턴스의 값을 format에 지정된 내용에 따라 나타낸 문자열 표현입니다.The string representation of the value of this instance as specified by format.

예외

format에 잘못된 사양이 들어 있습니다.format contains an invalid specification.

format이 "X"와 같지만 열거형 형식을 알 수 없습니다.format equals "X", but the enumeration type is unknown.

예제

다음 예제에서는 열거 된 값을 문자열로 변환 하는 방법에 설명 합니다.The following example demonstrates how to convert an enumerated value to a string.

// 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)
Imports System

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 'Main
End Class 'Sample
'
'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" (형식 문자열은 대/소문자 구분).The format parameter can be one of the following format strings: "G" or "g", "D" or "d", "X" or "x", and "F" or "f" (the format string is not case-sensitive). 하는 경우 formatnull 또는 빈 문자열 (""), 일반 형식 지정자 ("G")만 사용 합니다.If format is null or an empty string (""), the general format specifier ("G") is used. 열거형 형식 문자열 및 서식 지정 열거형 값에 대 한 자세한 내용은 참조 하세요. 열거형 형식 문자열합니다.For more information about the enumeration format strings and formatting enumeration values, see Enumeration Format Strings. 일반 형식 지정에 대 한 자세한 내용은 참조 하세요. 형식합니다.For more information about formatting in general, see Formatting Types.

호출자 참고

여러 열거형 멤버는 같은 기본 값을 가질 경우 기본 값을 기준으로 하는 열거형 멤버의 이름의 문자열 표현을 검색 하려고 하면 코드는 메서드는 반환는 이름에 대 한 어떠한가 정도 하지 확인 해야 합니다.If multiple enumeration members have the same underlying value and you attempt to retrieve the string representation of an enumeration member's name based on its underlying value, your code should not make any assumptions about which name the method will return. 다음 열거형은 두 명의 멤버를 정의 하는 예를 들어 Shade.Gray 하 고 Shade.Grey, 기본값이 있는 합니다.For example, the following enumeration defines two members, Shade.Gray and Shade.Grey, that have the same underlying value.

[! 코드 csharpSystem.Enum.ToString#1] [! 코드 vbSystem.Enum.ToString#1][!code-csharpSystem.Enum.ToString#1] [!code-vbSystem.Enum.ToString#1] 멤버의 이름을 검색 하려면 다음 메서드 호출은 시도 합니다 음영 기본 값이 1 인 열거형입니다.The following method call attempts to retrieve the name of a member of the Shade enumeration whose underlying value is 1. "Gray" 또는 "Grey" 메서드를 반환할 수 있습니다 하 고 코드에 대 한 문자열 반환할 어떠한가 정도 하지 않아야 합니다.The method can return either "Gray" or "Grey", and your code should not make any assumptions about which string will be returned.

[! 코드 csharpSystem.Enum.ToString#3] [! 코드 vbSystem.Enum.ToString#3][!code-csharpSystem.Enum.ToString#3] [!code-vbSystem.Enum.ToString#3]

추가 정보

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

경고

이 API는 현재 사용되지 않습니다.

이 메서드 오버로드는 더 이상 사용되지 않으므로 ToString()을 사용합니다.This method overload is obsolete; use ToString().

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

매개 변수

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

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

반환

이 인스턴스 값의 문자열 표현입니다.The string representation of the value of this instance.

구현

ToString() ToString() ToString() ToString()

이 인스턴스의 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of this instance to its equivalent string representation.

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

반환

이 인스턴스 값의 문자열 표현입니다.The string representation of the value of this instance.

예제

다음 예제에서는 열거 된 값을 문자열로 변환 하는 방법을 보여 줍니다.The following example demonstrates converting an enumerated value to a 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'.
*/
Imports System

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")를 사용 하 여 반환 값의 서식을 지정 합니다.The return value is formatted with the general format specifier ("G"). 즉, 하는 경우는 FlagsAttribute 에 적용 되지 않습니다이 열거 형식 하 고이 인스턴스의 값을 명명 된 상수와 같은 반환 값은 상수 이름을 포함 하는 문자열입니다.That is, if the FlagsAttribute is not applied to this enumerated type and there is a named constant equal to the value of this instance, then the return value is a string containing the name of the constant. 경우는 FlagsAttribute 적용 되는이 인스턴스의 값과 같은 하나 이상의 명명 된 상수를 조합 하 고 반환 값은 구분 상수의 이름 목록을 포함 하는 문자열입니다.If the FlagsAttribute is applied and there is a combination of one or more named constants equal to the value of this instance, then the return value is a string containing a delimiter-separated list of the names of the constants. 그렇지 않은 경우 반환 값은이 인스턴스의 숫자 값의 문자열 표현입니다.Otherwise, the return value is the string representation of the numeric value of this instance. 서식 지정 열거형 값에 대 한 자세한 내용은 참조 하세요. 열거형 형식 문자열합니다.For more information about formatting enumeration values, see Enumeration Format Strings. 일반 형식 지정에 대 한 자세한 내용은 참조 하세요. 형식합니다.For more information about formatting in general, see Formatting Types.

호출자 참고

여러 열거형 멤버는 같은 기본 값을 가질 경우 기본 값을 기준으로 하는 열거형 멤버의 이름의 문자열 표현을 검색 하려고 하면 코드는 메서드는 반환는 이름에 대 한 어떠한가 정도 하지 확인 해야 합니다.If multiple enumeration members have the same underlying value and you attempt to retrieve the string representation of an enumeration member's name based on its underlying value, your code should not make any assumptions about which name the method will return. 다음 열거형은 두 명의 멤버를 정의 하는 예를 들어 Shade.Gray 하 고 Shade.Grey, 기본값이 있는 합니다.For example, the following enumeration defines two members, Shade.Gray and Shade.Grey, that have the same underlying value.

[! 코드 csharpSystem.Enum.ToString#1] [! 코드 vbSystem.Enum.ToString#1][!code-csharpSystem.Enum.ToString#1] [!code-vbSystem.Enum.ToString#1] 멤버의 이름을 검색 하려면 다음 메서드 호출은 시도 합니다 음영 기본 값이 1 인 열거형입니다.The following method call attempts to retrieve the name of a member of the Shade enumeration whose underlying value is 1. "Gray" 또는 "Grey" 메서드를 반환할 수 있습니다 하 고 코드에 대 한 문자열 반환할 어떠한가 정도 하지 않아야 합니다.The method can return either "Gray" or "Grey", and your code should not make any assumptions about which string will be returned.

[! 코드 csharpSystem.Enum.ToString#2] [! 코드 vbSystem.Enum.ToString#2][!code-csharpSystem.Enum.ToString#2] [!code-vbSystem.Enum.ToString#2]

추가 정보

적용 대상