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

Definizione

Converte il valore dell'istanza corrente nell'equivalente rappresentazione di stringa.Converts the value of this instance to its equivalent string representation.

Overload

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

L'overload di questo metodo è obsoleto; usare ToString(String).This method overload is obsolete; use ToString(String).

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

Converte il valore dell'istanza corrente nella rappresentazione di stringa equivalente, usando il formato specificato.Converts the value of this instance to its equivalent string representation using the specified format.

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

L'overload di questo metodo è obsoleto; usare ToString().This method overload is obsolete; use ToString().

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

Converte il valore dell'istanza corrente nell'equivalente rappresentazione di stringa.Converts the value of this instance to its equivalent string representation.

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

Avviso

Questa API è ora obsoleta.

L'overload di questo metodo è obsoleto; usare 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

Parametri

format
String String String String

Specifica di formato.A format specification.

Restituisce

Rappresentazione di stringa del valore dell'istanza, in base a quanto specificato da format.The string representation of the value of this instance as specified by format.

Implementazioni

Eccezioni

format non contiene una specifica di formato valida.format does not contain a valid format specification.

format è uguale a "X", ma il tipo di enumerazione è sconosciuto.format equals "X", but the enumeration type is unknown.

Commenti

Il format parametro può essere una delle stringhe di formato seguenti: "G" o "g", "D" o "d", "X" o "x" e "F" o "f" (la stringa di formato non fa distinzione tra maiuscole e minuscole).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). Se format ènull o una stringa vuota (""), viene utilizzato l'identificatore di formato generale ("G").If format is null or an empty string (""), the general format specifier ("G") is used. Per ulteriori informazioni sulle stringhe di formato di enumerazione e i valori di enumerazione di formattazione, vedere stringhe di formato di enumerazione.For more information about the enumeration format strings and formatting enumeration values, see Enumeration Format Strings. Per ulteriori informazioni sulla formattazione in generale, vedere formattazione di tipi.For more information about formatting in general, see Formatting Types.

Specificare solo format. il provider parametro è obsoleto.Specify only format; the provider parameter is obsolete.

Vedi anche

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

Converte il valore dell'istanza corrente nella rappresentazione di stringa equivalente, usando il formato specificato.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

Parametri

format
String String String String

Stringa di formato.A format string.

Restituisce

Rappresentazione di stringa del valore dell'istanza, in base a quanto specificato da format.The string representation of the value of this instance as specified by format.

Eccezioni

format contiene una specifica non valida.format contains an invalid specification.

format è uguale a "X", ma il tipo di enumerazione è sconosciuto.format equals "X", but the enumeration type is unknown.

Esempi

Nell'esempio seguente viene illustrato come convertire un valore enumerato in una stringa.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
'

Commenti

Il format parametro può essere una delle stringhe di formato seguenti: "G" o "g", "D" o "d", "X" o "x" e "F" o "f" (la stringa di formato non fa distinzione tra maiuscole e minuscole).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). Se format ènull o una stringa vuota (""), viene utilizzato l'identificatore di formato generale ("G").If format is null or an empty string (""), the general format specifier ("G") is used. Per ulteriori informazioni sulle stringhe di formato di enumerazione e i valori di enumerazione di formattazione, vedere stringhe di formato di enumerazione.For more information about the enumeration format strings and formatting enumeration values, see Enumeration Format Strings. Per ulteriori informazioni sulla formattazione in generale, vedere formattazione di tipi.For more information about formatting in general, see Formatting Types.

Note per i chiamanti

Se più membri di enumerazione hanno lo stesso valore sottostante e si tenta di recuperare la rappresentazione di stringa del nome di un membro di enumerazione in base al relativo valore sottostante, il codice non deve fare supposizioni sul nome restituito dal metodo.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. L'enumerazione seguente, ad esempio, definisce due membri, Shade. Gray e Shade. grey, che hanno lo stesso valore sottostante.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] La chiamata al metodo seguente tenta di recuperare il nome di un membro dell'enumerazione shader il cui valore sottostante è 1.The following method call attempts to retrieve the name of a member of the Shade enumeration whose underlying value is 1. Il metodo può restituire "Gray" o "Grey" e il codice non deve creare ipotesi sulla stringa che verrà restituita.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]

Vedi anche

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

Avviso

Questa API è ora obsoleta.

L'overload di questo metodo è obsoleto; usare 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

Parametri

Restituisce

Rappresentazione di stringa del valore dell'istanza.The string representation of the value of this instance.

Implementazioni

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

Converte il valore dell'istanza corrente nell'equivalente rappresentazione di stringa.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

Restituisce

Rappresentazione di stringa del valore dell'istanza.The string representation of the value of this instance.

Esempi

Nell'esempio seguente viene illustrata la conversione di un valore enumerato in una stringa.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'.

Commenti

Il valore restituito è formattato con l'identificatore di formato generale ("G").The return value is formatted with the general format specifier ("G"). Ovvero, se l'oggetto FlagsAttribute non viene applicato a questo tipo enumerato ed esiste una costante denominata uguale al valore di questa istanza, il valore restituito è una stringa contenente il nome della costante.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 Se viene applicato ed è presente una combinazione di una o più costanti denominate uguali al valore di questa istanza, il valore restituito è una stringa che contiene un elenco delimitato da delimitatori dei nomi delle costanti.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. In caso contrario, il valore restituito è la rappresentazione di stringa del valore numerico di questa istanza.Otherwise, the return value is the string representation of the numeric value of this instance. Per ulteriori informazioni sulla formattazione dei valori di enumerazione, vedere stringhe di formato di enumerazione.For more information about formatting enumeration values, see Enumeration Format Strings. Per ulteriori informazioni sulla formattazione in generale, vedere formattazione di tipi.For more information about formatting in general, see Formatting Types.

Note per i chiamanti

Se più membri di enumerazione hanno lo stesso valore sottostante e si tenta di recuperare la rappresentazione di stringa del nome di un membro di enumerazione in base al relativo valore sottostante, il codice non deve fare supposizioni sul nome restituito dal metodo.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. L'enumerazione seguente, ad esempio, definisce due membri, Shade. Gray e Shade. grey, che hanno lo stesso valore sottostante.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] La chiamata al metodo seguente tenta di recuperare il nome di un membro dell'enumerazione shader il cui valore sottostante è 1.The following method call attempts to retrieve the name of a member of the Shade enumeration whose underlying value is 1. Il metodo può restituire "Gray" o "Grey" e il codice non deve creare ipotesi sulla stringa che verrà restituita.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]

Vedi anche

Si applica a