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.

仅指定format;provider参数已作废。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.GrayShade.Grey,具有相同的基础值。For example, the following enumeration defines two members, Shade.Gray and Shade.Grey, that have the same underlying value.

[!code-csharpSystem.Enum.ToString#1] [!code-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.

[!code-csharpSystem.Enum.ToString#3] [!code-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.GrayShade.Grey,具有相同的基础值。For example, the following enumeration defines two members, Shade.Gray and Shade.Grey, that have the same underlying value.

[!code-csharpSystem.Enum.ToString#1] [!code-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.

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

另请参阅

适用于