Decimal.ToString Metodo

Riferimento

Definizione

Spazio dei nomi:: System

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Converte il valore numerico dell'istanza nella rappresentazione String equivalente.

Overload

ToString()	Converte il valore numerico dell'istanza nella rappresentazione di stringa equivalente.
ToString(IFormatProvider)	Converte il valore numerico di questa istanza nella rappresentazione di stringa equivalente usando le informazioni di formato specifiche delle impostazioni cultura.
ToString(String)	Converte il valore numerico di questa istanza nell'equivalente rappresentazione di stringa usando il formato specificato.
ToString(String, IFormatProvider)	Converte il valore numerico dell'istanza nella rappresentazione di stringa equivalente usando il formato specificato e le informazioni di formattazione specifiche delle impostazioni cultura.

ToString()

Origine:: Decimal.cs

Origine:: Decimal.cs

Origine:: Decimal.cs

Converte il valore numerico dell'istanza nella rappresentazione di stringa equivalente.

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

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Restituisce

String

Stringa che rappresenta il valore di questa istanza.

Esempio

Nell'esempio seguente viene visualizzato un Decimal valore usando il metodo predefinito ToString() . Vengono inoltre visualizzate le rappresentazioni di stringa del Decimal valore risultante dall'uso di un numero di identificatori di formato standard.

decimal value = -16325.62m;
// Display value using default ToString method.
Console.WriteLine(value.ToString());            // Displays -16325.62
// Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"));         // Displays -16325.62
Console.WriteLine(value.ToString("C"));         // Displays ($16,325.62)
Console.WriteLine(value.ToString("F"));         // Displays -16325.62

let value = -16325.62m
// Display value using default ToString method.
printfn $"{value.ToString()}"            // Displays -16325.62
// Display value using some standard format specifiers.
printfn $"""{value.ToString "G"}"""      // Displays -16325.62
printfn $"""{value.ToString "C"}"""      // Displays ($16,325.62)
printfn $"""{value.ToString "F"}"""      // Displays -16325.62

Dim value As Decimal = -16325.62d
' Display value using default ToString method.
Console.WriteLine(value.ToString())            ' Displays -16325.62
' Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"))         ' Displays -16325.62
Console.WriteLine(value.ToString("C"))         ' Displays ($16,325.62)
Console.WriteLine(value.ToString("F"))         ' Displays -16325.62

Nell'esempio seguente viene visualizzato l'importo di denaro in un conto.

   public ref class PiggyBank
   {
   public:
      void AddPenny()
      {
         MyFortune = Decimal::Add( MyFortune, (Decimal).01 );
      }

      virtual System::String^ ToString() override
      {
         return MyFortune.ToString("C")+" in piggy bank";
      }

   protected:
      Decimal MyFortune;
   };
}

class PiggyBank {
    public void AddPenny() {
        MyFortune = Decimal.Add(MyFortune, .01m);
    }

    public override string ToString() {
        return MyFortune.ToString("C")+" in piggy bank";
    }

    protected decimal MyFortune;
}

type PiggyBank() =
    let mutable myFortune = 0m

    member _.AddPenny() =
        myFortune <- Decimal.Add(myFortune, 0.01m)

    override _.ToString() =
        $"{myFortune:C} in piggy bank"

Class PiggyBank

    Public Sub AddPenny()
        MyFortune = [Decimal].Add(MyFortune, 0.01D)
    End Sub

    Public Overrides Function ToString() As String
        Return MyFortune.ToString("C") + " in piggy bank"
    End Function

    Protected MyFortune As Decimal
End Class

Commenti

Il ToString() metodo formatta un Decimal valore nel formato predefinito ("G" o generale) delle impostazioni cultura correnti. Se si desidera specificare un formato o impostazioni cultura diverse, usare gli altri overload del ToString metodo, come indicato di seguito:

Per usare il formato	Per le impostazioni cultura	Usare l'overload
Formato predefinito ("G")	Impostazioni cultura specifiche	ToString(IFormatProvider)
Un formato specifico	Impostazioni cultura predefinite (correnti)	ToString(String)
Un formato specifico	Impostazioni cultura specifiche	ToString(String, IFormatProvider)

.NET offre un supporto completo per la formattazione, descritto in modo più dettagliato negli argomenti di formattazione seguenti:

Per altre informazioni sugli identificatori di formato numerico, vedere Stringhe di formato numerico standard e stringhe di formato numerico personalizzato.
Per altre informazioni sulla formattazione, vedere Formattazione dei tipi.

Vedi anche

Si applica a

ToString(IFormatProvider)

Origine:: Decimal.cs

Origine:: Decimal.cs

Origine:: Decimal.cs

Converte il valore numerico di questa istanza nella rappresentazione di stringa equivalente usando le informazioni di formato specifiche delle impostazioni cultura.

public:
 virtual System::String ^ ToString(IFormatProvider ^ provider);

public:
 System::String ^ ToString(IFormatProvider ^ provider);

public string ToString (IFormatProvider provider);

public string ToString (IFormatProvider? provider);

override this.ToString : IFormatProvider -> string

Public Function ToString (provider As IFormatProvider) As String

Parametri

provider: IFormatProvider

Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura.

Restituisce

String

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

Implementazioni

ToString(IFormatProvider)

Esempio

Nell'esempio seguente viene visualizzata la rappresentazione di stringa di un Decimal valore utilizzando CultureInfo oggetti che rappresentano diverse impostazioni cultura.

decimal value = -16325.62m;
// Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture));
// Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")));
// Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")));
// This example displays the following output to the console:
//       -16325.62
//       -16325.62
//       -16325,62

let value = -16325.62m
// Display value using the invariant culture.
printfn $"{value.ToString CultureInfo.InvariantCulture}"
// Display value using the en-GB culture.
printfn $"""{value.ToString(CultureInfo.CreateSpecificCulture "en-GB")}"""
// Display value using the de-DE culture.
printfn $"""{value.ToString(CultureInfo.CreateSpecificCulture "de-DE")}"""
// This example displays the following output to the console:
//       -16325.62
//       -16325.62
//       -16325,62

Dim value As Decimal = -16325.62d
' Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture))
' Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")))
' Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")))
' This example displays the following output to the console:
'       -16325.62
'       -16325.62
'       -16325,62

Commenti

Il ToString(IFormatProvider) metodo formatta un Decimal valore nel formato predefinito ("G" o generale) di impostazioni cultura specificate. Se si desidera specificare un formato diverso o le impostazioni cultura correnti, usare gli altri overload del ToString metodo, come indicato di seguito:

Per usare il formato	Per le impostazioni cultura	Usare l'overload
Formato predefinito ("G")	Impostazioni cultura predefinite (correnti)	ToString()
Un formato specifico	Impostazioni cultura predefinite (correnti)	ToString(String)
Un formato specifico	Impostazioni cultura specifiche	ToString(String, IFormatProvider)

.NET offre un supporto completo per la formattazione, descritto in modo più dettagliato negli argomenti di formattazione seguenti:

Per altre informazioni sugli identificatori di formato numerico, vedere Stringhe di formato numerico standard e stringhe di formato numerico personalizzato.
Per altre informazioni sulla formattazione, vedere Formattazione dei tipi.

Il provider parametro è un'implementazione IFormatProvider il cui IFormatProvider.GetFormat metodo restituisce un NumberFormatInfo oggetto . In genere, provider è un NumberFormatInfo oggetto o un CultureInfo oggetto . Il provider parametro fornisce informazioni specifiche delle impostazioni cultura usate nella formattazione. Se provider è null, verranno usate le impostazioni cultura correnti del thread.

Per convertire un Decimal valore nella relativa rappresentazione di stringa usando impostazioni cultura specificate e una stringa di formato specifica, chiamare il Decimal.ToString(String, IFormatProvider) metodo .

Vedi anche

Si applica a

ToString(String)

Origine:: Decimal.cs

Origine:: Decimal.cs

Origine:: Decimal.cs

Converte il valore numerico di questa istanza nell'equivalente rappresentazione di stringa usando il formato specificato.

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

Parametri

format: String

Stringa di formato numerico standard o personalizzato.

Restituisce

String

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

Eccezioni

FormatException

format non è valido.

Esempio

Nell'esempio seguente viene visualizzato un Decimal valore usando ognuno degli identificatori di formato numerico standard supportati, insieme a due stringhe di formato numerico personalizzate. Nella conversione dei valori numerici in stringhe, nell'esempio vengono utilizzate le convenzioni di formattazione delle impostazioni cultura en-US.

decimal value = 16325.62m;
string specifier;

// Use standard numeric format specifiers.
specifier = "G";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    G: 16325.62
specifier = "C";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    C: $16,325.62
specifier = "E04";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    E04: 1.6326E+004
specifier = "F";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    F: 16325.62
specifier = "N";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    N: 16,325.62
specifier = "P";
Console.WriteLine("{0}: {1}", specifier, (value/10000).ToString(specifier));
// Displays:    P: 163.26 %

// Use custom numeric format specifiers.
specifier = "0,0.000";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    0,0.000: 16,325.620
specifier = "#,#.00#;(#,#.00#)";
Console.WriteLine("{0}: {1}", specifier, (value*-1).ToString(specifier));
// Displays:    #,#.00#;(#,#.00#): (16,325.62)

let value = 16325.62m

// Use standard numeric format specifiers.
let specifier = "G"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    G: 16325.62
let specifier = "C"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    C: $16,325.62
let specifier = "E04"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    E04: 1.6326E+004
let specifier = "F"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    F: 16325.62
let specifier = "N"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    N: 16,325.62
let specifier = "P"
printfn $"{specifier}: {(value / 10000m).ToString specifier}"
// Displays:    P: 163.26 %

// Use custom numeric format specifiers.
let specifier = "0,0.000"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    0,0.000: 16,325.620
let specifier = "#,#.00#(#,#.00#)"
printfn $"{specifier}: {(value * -1m).ToString specifier}"
// Displays:    #,#.00#(#,#.00#): (16,325.62)

Dim value As Decimal = 16325.62d
Dim specifier As String

' Use standard numeric format specifiers.
specifier = "G"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    G: 16325.62
specifier = "C"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    C: $16,325.62
specifier = "E04"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    E04: 1.6326E+004
specifier = "F"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    F: 16325.62
specifier = "N"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    N: 16,325.62
specifier = "P"
Console.WriteLine("{0}: {1}", specifier, (value/10000).ToString(specifier))
' Displays:    P: 163.26 %

' Use custom numeric format specifiers.
specifier = "0,0.000"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    0,0.000: 16,325.620
specifier = "#,#.00#;(#,#.00#)"
Console.WriteLine("{0}: {1}", specifier, (value*-1).ToString(specifier))
' Displays:    #,#.00#;(#,#.00#): (16,325.62)

Commenti

Il ToString(String) metodo formatta un Decimal valore in un formato specificato usando le convenzioni delle impostazioni cultura correnti. Se si desidera usare il formato predefinito ("G" o generale) o specificare impostazioni cultura diverse, usare gli altri overload del ToString metodo, come indicato di seguito:

Per usare il formato	Per le impostazioni cultura	Usare l'overload
Formato predefinito ("G")	Impostazioni cultura predefinite (correnti)	ToString()
Formato predefinito ("G")	Impostazioni cultura specifiche	ToString(IFormatProvider)
Un formato specifico	Impostazioni cultura specifiche	ToString(String, IFormatProvider)

Il ToString metodo usa la stringa di formato numerico standard o personalizzata specificata dal format parametro per convertire il valore dell'istanza corrente nella relativa rappresentazione di stringa. Il format parametro può essere qualsiasi identificatore di formato numerico standard valido, ad eccezione di D, R e X, nonché qualsiasi combinazione di identificatori di formato numerico personalizzati. Se format è null o una stringa vuota, il valore restituito di questa istanza viene formattato con l'identificatore di formato numerico generale (G).

.NET offre un supporto completo per la formattazione, descritto in modo più dettagliato negli argomenti di formattazione seguenti:

Per altre informazioni sugli identificatori di formato numerico, vedere Stringhe di formato numerico standard e stringhe di formato numerico personalizzato.
Per altre informazioni sulla formattazione, vedere Formattazione dei tipi.

Il valore restituito viene formattato utilizzando l'oggetto NumberFormatInfo per le impostazioni cultura correnti. Per applicare le convenzioni di formattazione di impostazioni cultura specificate, chiamare il ToString(String, IFormatProvider) metodo .

Vedi anche

Si applica a

ToString(String, IFormatProvider)

Origine:: Decimal.cs

Origine:: Decimal.cs

Origine:: Decimal.cs

Converte il valore numerico dell'istanza nella rappresentazione di stringa equivalente usando il formato specificato e le informazioni di formattazione specifiche delle impostazioni cultura.

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);

public string ToString (string format, IFormatProvider provider);

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

Stringa di formato numerico.

provider: IFormatProvider

Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura.

Restituisce

String

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

Implementazioni

ToString(String, IFormatProvider)

Eccezioni

FormatException

format non è valido.

Esempio

Nell'esempio seguente viene visualizzato un Decimal valore usando ognuno degli identificatori di formato numerico standard supportati per diverse impostazioni cultura.

decimal value = 16325.62m;
string specifier;
CultureInfo culture;

// Use standard numeric format specifiers.
specifier = "G";
culture = CultureInfo.CreateSpecificCulture("eu-ES");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16325,62
Console.WriteLine(value.ToString(specifier, CultureInfo.InvariantCulture));
// Displays:    16325.62

specifier = "C";
culture = CultureInfo.CreateSpecificCulture("en-US");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    $16,325.62
culture = CultureInfo.CreateSpecificCulture("en-GB");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    £16,325.62

specifier = "E04";
culture = CultureInfo.CreateSpecificCulture("sv-SE");
Console.WriteLine(value.ToString(specifier, culture));
// Displays: 1,6326E+004
 culture = CultureInfo.CreateSpecificCulture("en-NZ");
 Console.WriteLine(value.ToString(specifier, culture));
// Displays:    1.6326E+004

specifier = "F";
culture = CultureInfo.CreateSpecificCulture("fr-FR");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16325,62
culture = CultureInfo.CreateSpecificCulture("en-CA");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16325.62

specifier = "N";
culture = CultureInfo.CreateSpecificCulture("es-ES");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16.325,62
culture = CultureInfo.CreateSpecificCulture("fr-CA");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16 325,62

specifier = "P";
culture = CultureInfo.InvariantCulture;
Console.WriteLine((value/10000).ToString(specifier, culture));
// Displays:    163.26 %
culture = CultureInfo.CreateSpecificCulture("ar-EG");
Console.WriteLine((value/10000).ToString(specifier, culture));
// Displays:    163.256 %

let value = 16325.62m

// Use standard numeric format specifiers.
let specifier = "G"
let culture = CultureInfo.CreateSpecificCulture "eu-ES"
Console.WriteLine(value.ToString(specifier, culture))
// Displays:    16325,62
Console.WriteLine(value.ToString(specifier, CultureInfo.InvariantCulture))
// Displays:    16325.62

let specifier = "C"
let culture = CultureInfo.CreateSpecificCulture "en-US"
Console.WriteLine(value.ToString(specifier, culture))
// Displays:    $16,325.62
let culture = CultureInfo.CreateSpecificCulture "en-GB"
Console.WriteLine(value.ToString(specifier, culture))
// Displays:    £16,325.62

let specifier = "E04"
let culture = CultureInfo.CreateSpecificCulture "sv-SE"
Console.WriteLine(value.ToString(specifier, culture))
// Displays: 1,6326E+004
let culture = CultureInfo.CreateSpecificCulture "en-NZ"
Console.WriteLine(value.ToString(specifier, culture))
// Displays:    1.6326E+004

let specifier = "F"
let culture = CultureInfo.CreateSpecificCulture "fr-FR"
Console.WriteLine(value.ToString(specifier, culture))
// Displays:    16325,62
let culture = CultureInfo.CreateSpecificCulture "en-CA"
Console.WriteLine(value.ToString(specifier, culture))
// Displays:    16325.62

let specifier = "N"
let culture = CultureInfo.CreateSpecificCulture "es-ES"
Console.WriteLine(value.ToString(specifier, culture))
// Displays:    16.325,62
let culture = CultureInfo.CreateSpecificCulture "fr-CA"
Console.WriteLine(value.ToString(specifier, culture))
// Displays:    16 325,62

let specifier = "P"
let culture = CultureInfo.InvariantCulture
printfn $"{(value / 10000m).ToString(specifier, culture)}"
// Displays:    163.26 %
let culture = CultureInfo.CreateSpecificCulture "ar-EG"
printfn $"{(value / 10000m).ToString(specifier, culture)}"
// Displays:    163.256 %

Dim value As Decimal = 16325.62d
Dim specifier As String
Dim culture As CultureInfo

' Use standard numeric format specifiers.
specifier = "G"
culture = CultureInfo.CreateSpecificCulture("eu-ES")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16325,62
Console.WriteLine(value.ToString(specifier, CultureInfo.InvariantCulture))
' Displays:    16325.62

specifier = "C"
culture = CultureInfo.CreateSpecificCulture("en-US")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    $16,325.62
culture = CultureInfo.CreateSpecificCulture("en-GB")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    £16,325.62

specifier = "E04"
culture = CultureInfo.CreateSpecificCulture("sv-SE")
Console.WriteLine(value.ToString(specifier, culture))
' Displays: 1,6326E+004   
 culture = CultureInfo.CreateSpecificCulture("en-NZ")
 Console.WriteLine(value.ToString(specifier, culture))
' Displays:    1.6326E+004   

specifier = "F"
culture = CultureInfo.CreateSpecificCulture("fr-FR")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16325,62
culture = CultureInfo.CreateSpecificCulture("en-CA")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16325.62

specifier = "N"
culture = CultureInfo.CreateSpecificCulture("es-ES")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16.325,62
culture = CultureInfo.CreateSpecificCulture("fr-CA")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16 325,62

specifier = "P"
culture = CultureInfo.InvariantCulture
Console.WriteLine((value/10000).ToString(specifier, culture))
' Displays:    163.26 %
culture = CultureInfo.CreateSpecificCulture("ar-EG")
Console.WriteLine((value/10000).ToString(specifier, culture))
' Displays:    163.256 %

Commenti

Il ToString(String, IFormatProvider) metodo formatta un Decimal valore in un formato specificato di impostazioni cultura specificate. Se si desidera usare le impostazioni di formato o impostazioni cultura predefinite, usare gli altri overload del ToString metodo, come indicato di seguito:

Per usare il formato	Per le impostazioni cultura	Usare l'overload
Formato predefinito ("G")	Impostazioni cultura predefinite (correnti)	ToString()
Formato predefinito ("G")	Impostazioni cultura specifiche	ToString(IFormatProvider)
Un formato specifico	Impostazioni cultura predefinite (correnti)	ToString(String)

Il format parametro può essere qualsiasi identificatore di formato numerico standard valido, ad eccezione di D, R e X, nonché qualsiasi combinazione di identificatori di formato numerico personalizzati. Se format è null o una stringa vuota, il valore restituito per questa istanza viene formattato con l'identificatore di formato numerico generale ("G").

.NET offre un supporto completo per la formattazione, descritto in modo più dettagliato negli argomenti di formattazione seguenti:

Per altre informazioni sugli identificatori di formato numerico, vedere Stringhe di formato numerico standard e stringhe di formato numerico personalizzato.
Per altre informazioni sulla formattazione, vedere Formattazione dei tipi.

Il provider parametro è un'implementazione IFormatProvider il cui IFormatProvider.GetFormat metodo restituisce un NumberFormatInfo oggetto . In genere, provider è un NumberFormatInfo oggetto o CultureInfo . Il provider parametro fornisce informazioni specifiche delle impostazioni cultura usate nella formattazione. Se provider è null, verranno usate le impostazioni cultura correnti del thread.

Vedi anche

Si applica a

Condividi tramite

Decimal.ToString Metodo

Definizione

Overload

ToString()

Restituisce

Esempio

Commenti

Vedi anche

Si applica a

ToString(IFormatProvider)

Parametri

Restituisce

Implementazioni

Esempio

Commenti

Vedi anche

Si applica a

ToString(String)

Parametri

Restituisce

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

ToString(String, IFormatProvider)

Parametri

Restituisce

Implementazioni

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

Risorse aggiuntive