Enum.ToString Methode

Definition

Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung.Converts the value of this instance to its equivalent string representation.

Überlädt

ToString(IFormatProvider)
Veraltet.

Diese Methodenüberladung ist veraltet. Verwenden Sie ToString().This method overload is obsolete; use ToString().

ToString(String)

Konvertiert den Wert dieser Instanz anhand des angegebenen Formats in die entsprechende Zeichenfolgendarstellung.Converts the value of this instance to its equivalent string representation using the specified format.

ToString(String, IFormatProvider)
Veraltet.

Diese Methodenüberladung ist veraltet. Verwenden Sie ToString(String).This method overload is obsolete; use ToString(String).

ToString()

Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung.Converts the value of this instance to its equivalent string representation.

ToString(IFormatProvider)

Achtung

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

Diese Methodenüberladung ist veraltet. Verwenden Sie 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);
[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
override this.ToString : IFormatProvider -> string
Public Function ToString (provider As IFormatProvider) As String

Parameter

provider
IFormatProvider

(Veraltet)(obsolete)

Gibt zurück

String

Die Zeichenfolgendarstellung des Werts dieser Instanz.The string representation of the value of this instance.

Implementiert

Attribute

Gilt für:

ToString(String)

Konvertiert den Wert dieser Instanz anhand des angegebenen Formats in die entsprechende Zeichenfolgendarstellung.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);
public string ToString (string? format);
override this.ToString : string -> string
Public Function ToString (format As String) As String

Parameter

format
String

Eine Formatzeichenfolge.A format string.

Gibt zurück

String

Die Zeichenfolgendarstellung des Werts dieser Instanz entsprechend den Angaben von format.The string representation of the value of this instance as specified by format.

Ausnahmen

format enthält eine ungültige Angabe.format contains an invalid specification.

format entspricht „X“, aber der Enumerationstyp ist unbekannt.format equals "X", but the enumeration type is unknown.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie ein Enumerationswert in eine Zeichenfolge konvertiert wird.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)
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
'

Hinweise

Der format Parameter kann eine der folgenden Format Zeichenfolgen sein: "g" oder "g", "d" oder "d", "x" oder "x" und "f" oder "f" (bei der Format Zeichenfolge wird die Groß-/Kleinschreibung nicht beachtet).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). Wenn format null oder eine leere Zeichenfolge ("") ist, wird der allgemeine Format Bezeichner ("G") verwendet.If format is null or an empty string (""), the general format specifier ("G") is used. Weitere Informationen zu Enumerationsformatzeichenfolgen und Formatierungen von Enumerationswerten finden Sie unter Enumerationsformatzeichenfolgen.For more information about the enumeration format strings and formatting enumeration values, see Enumeration Format Strings. Weitere Informationen zur allgemeinen Formatierung finden Sie unter Formatieren von Typen.For more information about formatting in general, see Formatting Types.

Hinweise für Aufrufer

Wenn mehrere Enumerationsmember denselben zugrunde liegenden Wert aufweisen und Sie versuchen, die Zeichen folgen Darstellung des Namens eines Enumerationsmembers basierend auf dem zugrunde liegenden Wert abzurufen, sollte der Code keine Annahmen darüber treffen, welcher Name von der Methode zurückgegeben wird.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. Die folgende Enumeration definiert z. b. zwei Member, schattiert. grau und Schattierung. Grey, die den gleichen zugrunde liegenden Wert aufweisen.For example, the following enumeration defines two members, Shade.Gray and Shade.Grey, that have the same underlying value.

[! Code-csharpSystem. Enum.-Zeichenfolge Nr. 1] [! Code-vbSystem. Enum.-Zeichenfolge Nr. 1][!code-csharpSystem.Enum.ToString#1] [!code-vbSystem.Enum.ToString#1] Der folgende Methoden Aufrufversuch versucht, den Namen eines Members der Schattierung abzurufen, dessen zugrunde liegender Wert 1 ist.The following method call attempts to retrieve the name of a member of the Shade enumeration whose underlying value is 1. Die Methode kann entweder "Gray" oder "Grey" zurückgeben, und Ihr Code sollte keine Annahmen darüber treffen, welche Zeichenfolge zurückgegeben wird.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.-Zeichenfolge Nr. 3] [! Code-vbSystem. Enum.-Zeichenfolge Nr. 3][!code-csharpSystem.Enum.ToString#3] [!code-vbSystem.Enum.ToString#3]

Siehe auch

Gilt für:

ToString(String, IFormatProvider)

Achtung

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

Diese Methodenüberladung ist veraltet. Verwenden Sie 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);
[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
override this.ToString : string * IFormatProvider -> string
Public Function ToString (format As String, provider As IFormatProvider) As String

Parameter

format
String

Eine Formatangabe.A format specification.

provider
IFormatProvider

(Veraltet)(Obsolete.)

Gibt zurück

String

Die Zeichenfolgendarstellung des Werts dieser Instanz entsprechend den Angaben von format.The string representation of the value of this instance as specified by format.

Implementiert

Attribute

Ausnahmen

format enthält keine gültige Formatangabe.format does not contain a valid format specification.

format entspricht „X“, aber der Enumerationstyp ist unbekannt.format equals "X", but the enumeration type is unknown.

Hinweise

Der format Parameter kann eine der folgenden Format Zeichenfolgen sein: "g" oder "g", "d" oder "d", "x" oder "x" und "f" oder "f" (bei der Format Zeichenfolge wird die Groß-/Kleinschreibung nicht beachtet).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). Wenn format null oder eine leere Zeichenfolge ("") ist, wird der allgemeine Format Bezeichner ("G") verwendet.If format is null or an empty string (""), the general format specifier ("G") is used. Weitere Informationen zu Enumerationsformatzeichenfolgen und Formatierungen von Enumerationswerten finden Sie unter Enumerationsformatzeichenfolgen.For more information about the enumeration format strings and formatting enumeration values, see Enumeration Format Strings. Weitere Informationen zur allgemeinen Formatierung finden Sie unter Formatieren von Typen.For more information about formatting in general, see Formatting Types.

Geben Sie nur an format . der- provider Parameter ist veraltet.Specify only format; the provider parameter is obsolete.

Siehe auch

Gilt für:

ToString()

Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung.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

Gibt zurück

String

Die Zeichenfolgendarstellung des Werts dieser Instanz.The string representation of the value of this instance.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie ein Enumerationswert in eine Zeichenfolge umgerechnet wird.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'.
*/
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'.

Hinweise

Der Rückgabewert ist mit dem allgemeinen Format Bezeichner ("G") formatiert.The return value is formatted with the general format specifier ("G"). Das heißt, wenn der FlagsAttribute nicht auf diesen enumerierten Typ angewendet wird und eine benannte Konstante gleich dem Wert dieser Instanz ist, ist der Rückgabewert eine Zeichenfolge, die den Namen der Konstante enthält.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. Wenn FlagsAttribute angewendet wird und eine Kombination aus einer oder mehreren benannten Konstanten gleich dem Wert dieser Instanz ist, ist der Rückgabewert eine Zeichenfolge, die eine durch Trennzeichen getrennte Liste mit den Namen der Konstanten enthält.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. Andernfalls ist der Rückgabewert die Zeichen folgen Darstellung des numerischen Werts dieser Instanz.Otherwise, the return value is the string representation of the numeric value of this instance. Weitere Informationen zum Formatieren von Enumerationswerten finden Sie unter Enumerationsformatzeichenfolgen.For more information about formatting enumeration values, see Enumeration Format Strings. Weitere Informationen zur allgemeinen Formatierung finden Sie unter Formatieren von Typen.For more information about formatting in general, see Formatting Types.

Hinweise für Aufrufer

Wenn mehrere Enumerationsmember denselben zugrunde liegenden Wert aufweisen und Sie versuchen, die Zeichen folgen Darstellung des Namens eines Enumerationsmembers basierend auf dem zugrunde liegenden Wert abzurufen, sollte der Code keine Annahmen darüber treffen, welcher Name von der Methode zurückgegeben wird.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. Die folgende Enumeration definiert z. b. zwei Member, schattiert. grau und Schattierung. Grey, die den gleichen zugrunde liegenden Wert aufweisen.For example, the following enumeration defines two members, Shade.Gray and Shade.Grey, that have the same underlying value.

[! Code-csharpSystem. Enum.-Zeichenfolge Nr. 1] [! Code-vbSystem. Enum.-Zeichenfolge Nr. 1][!code-csharpSystem.Enum.ToString#1] [!code-vbSystem.Enum.ToString#1] Der folgende Methoden Aufrufversuch versucht, den Namen eines Members der Schattierung abzurufen, dessen zugrunde liegender Wert 1 ist.The following method call attempts to retrieve the name of a member of the Shade enumeration whose underlying value is 1. Die Methode kann entweder "Gray" oder "Grey" zurückgeben, und Ihr Code sollte keine Annahmen darüber treffen, welche Zeichenfolge zurückgegeben wird.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.-Zeichenfolge # 2] [! Code-vbSystem. Enum. destring # 2][!code-csharpSystem.Enum.ToString#2] [!code-vbSystem.Enum.ToString#2]

Siehe auch

Gilt für: