Enum.ToString Metodo

Definizione

Spazio dei nomi:

System

Assembly:

System.Runtime.dll

Converte il valore dell'istanza corrente nell'equivalente rappresentazione di stringa.

Overload

ToString(String, IFormatProvider)	Obsoleti. L'overload di questo metodo è obsoleto; usare ToString(String).
ToString()	Converte il valore dell'istanza corrente nell'equivalente rappresentazione di stringa.
ToString(String)	Converte il valore dell'istanza corrente nella rappresentazione di stringa equivalente, usando il formato specificato.
ToString(IFormatProvider)	Obsoleti. L'overload di questo metodo è obsoleto; usare ToString().

ToString(String, IFormatProvider)

Origine:

Enum.cs

Attenzione

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

L'overload di questo metodo è obsoleto; usare ToString(String).

public:
 virtual System::String ^ ToString(System::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. Use ToString(String) instead.")>]
override this.ToString : string * IFormatProvider -> string

Public Function ToString (format As String, provider As IFormatProvider) As String

Parametri

format

String

Specifica di formato.

provider

IFormatProvider

(Obsoleto).

Restituisce

String

Rappresentazione di stringa del valore dell'istanza, in base a quanto specificato da format.

Implementazioni

ToString(String, IFormatProvider)

Attributi

ObsoleteAttribute

Eccezioni

FormatException

format non contiene una specifica di formato valida.

InvalidOperationException

format è uguale a "X", ma il tipo di enumerazione è sconosciuto.

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 è distinzione tra maiuscole e minuscole). Se format è null o una stringa vuota (""), viene usato l'identificatore di formato generale ("G"). Per altre informazioni sulle stringhe di formato di enumerazione e sulla formattazione dei valori di enumerazione, vedere Stringhe di formato enumerazione. Per altre informazioni sulla formattazione in generale, vedere Tipi di formattazione.

Specificare solo format; il provider parametro è obsoleto.

Vedi anche

• Format(Type, Object, String)
• Formattazione di tipi in .NET
• Stringhe di formato di enumerazione

ToString()

Origine:

Enum.cs

Converte il valore dell'istanza corrente nell'equivalente rappresentazione di stringa.

public:
 override System::String ^ ToString();

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Restituisce

String

Rappresentazione di stringa del valore dell'istanza.

Esempio

Nell'esempio seguente viene illustrata la conversione di un valore enumerato in una stringa.

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'.

Commenti

Il valore restituito viene formattato con l'identificatore di formato generale ("G"). Ovvero, se l'oggetto FlagsAttribute non viene applicato a questo tipo enumerato ed è presente una costante denominata uguale al valore di questa istanza, il valore restituito è una stringa contenente il nome della costante. Se l'oggetto FlagsAttribute viene applicato e esiste una combinazione di una o più costanti denominate uguali al valore di questa istanza, il valore restituito è una stringa contenente un elenco delimitatore separato dai nomi delle costanti. In caso contrario, il valore restituito è la rappresentazione stringa del valore numerico di questa istanza. Per altre informazioni sulla formattazione dei valori di enumerazione, vedere Stringhe di formato di enumerazione. Per altre informazioni sulla formattazione in generale, vedere Tipi di formattazione.

Note per i chiamanti

Se più membri dell'enumerazione hanno lo stesso valore sottostante e si tenta di recuperare la rappresentazione stringa del nome di un membro di enumerazione in base al relativo valore sottostante, il codice non deve effettuare ipotesi su quale nome restituirà il metodo. Ad esempio, l'enumerazione seguente definisce due membri Shade.Gray e , Shade.Greycon lo stesso valore sottostante.

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

type Shade =
    | White = 0
    | Gray = 1
    | Grey = 1
    | Black = 2

Public Enum Shade
   White = 0
   Gray = 1
   Grey = 1
   Black = 2
End Enum

La chiamata al metodo seguente tenta di recuperare il nome di un membro dell'enumerazione Shade il cui valore sottostante è 1. Il metodo può restituire "Grigio" o "Grigio" e il codice non deve effettuare ipotesi su quale stringa verrà restituita.

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

let shadeName = (enum<Shade> 1).ToString()

Dim shadeName As String = CType(1, Shade).ToString()

Vedi anche

• Format(Type, Object, String)
• Parse(Type, String)

ToString(String)

Origine:

Enum.cs

Converte il valore dell'istanza corrente nella rappresentazione di stringa equivalente, usando il formato specificato.

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

Stringa di formato.

Restituisce

String

Rappresentazione di stringa del valore dell'istanza, in base a quanto specificato da format.

Eccezioni

FormatException

format contiene una specifica non valida.

InvalidOperationException

format è uguale a "X", ma il tipo di enumerazione è sconosciuto.

Esempio

Nell'esempio seguente viene illustrato come convertire un valore enumerato in una stringa.

// 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
'

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 è distinzione tra maiuscole e minuscole). Se format è null o una stringa vuota (""), viene usato l'identificatore di formato generale ("G"). Per altre informazioni sulle stringhe di formato di enumerazione e sulla formattazione dei valori di enumerazione, vedere Stringhe di formato enumerazione. Per altre informazioni sulla formattazione in generale, vedere Tipi di formattazione.

Note per i chiamanti

Se più membri dell'enumerazione hanno lo stesso valore sottostante e si tenta di recuperare la rappresentazione stringa del nome di un membro di enumerazione in base al relativo valore sottostante, il codice non deve effettuare ipotesi su quale nome restituirà il metodo. Ad esempio, l'enumerazione seguente definisce due membri Shade.Gray e , Shade.Greycon lo stesso valore sottostante.

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

type Shade =
    | White = 0
    | Gray = 1
    | Grey = 1
    | Black = 2

Public Enum Shade
   White = 0
   Gray = 1
   Grey = 1
   Black = 2
End Enum

La chiamata al metodo seguente tenta di recuperare il nome di un membro dell'enumerazione Shade il cui valore sottostante è 1. Il metodo può restituire "Grigio" o "Grigio" e il codice non deve effettuare ipotesi su quale stringa verrà restituita.

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

let shadeName = (enum<Shade> 1).ToString "F"

Dim shadeName As String = CType(1, Shade).ToString("F")

Vedi anche

• Format(Type, Object, String)
• Parse(Type, String)
• ToString(String, IFormatProvider)
• Formattazione di tipi in .NET
• Stringhe di formato di enumerazione

ToString(IFormatProvider)

Origine:

Enum.cs

Attenzione

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

L'overload di questo metodo è obsoleto; usare ToString().

public:
 virtual System::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. Use ToString() instead.")>]
override this.ToString : IFormatProvider -> string

Public Function ToString (provider As IFormatProvider) As String

Parametri

provider

IFormatProvider

(obsoleto)

Restituisce

String

Rappresentazione di stringa del valore dell'istanza.

Implementazioni

ToString(IFormatProvider)

Attributi

ObsoleteAttribute