Decimal.ToString Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Convertit la valeur numérique de cette instance en sa représentation String équivalente.

Surcharges

ToString()	Convertit la valeur numérique de cette instance en sa représentation équivalente sous forme de chaîne.
ToString(IFormatProvider)	Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente à l'aide des informations de format spécifiques à la culture donnée.
ToString(String)	Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente en utilisant le format spécifié.
ToString(String, IFormatProvider)	Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente à l'aide du format spécifié et des informations de format spécifiques à la culture.

ToString()

Source:

Decimal.cs

Convertit la valeur numérique de cette instance en sa représentation équivalente sous forme de chaîne.

C#

public override string ToString ();

Retours

String

Une chaîne qui représente la valeur de cette instance.

Exemples

L’exemple suivant affiche une Decimal valeur à l’aide de la méthode par défaut ToString() . Il affiche également les représentations sous forme de chaîne de la valeur résultant de l’utilisation Decimal d’un certain nombre de spécificateurs de format standard.

C#

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

L’exemple suivant affiche le montant d’argent dans un compte.

C#

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

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

    protected decimal MyFortune;
}

Remarques

La ToString() méthode met en forme une Decimal valeur au format par défaut (« G », ou général) de la culture actuelle. Si vous souhaitez spécifier un autre format ou culture, utilisez les autres surcharges de la ToString méthode, comme suit :

Pour utiliser le format	Pour la culture	Utiliser la surcharge
Format par défaut (« G »)	Une culture spécifique	ToString(IFormatProvider)
Format spécifique	Culture par défaut (actuelle)	ToString(String)
Format spécifique	Une culture spécifique	ToString(String, IFormatProvider)

.NET fournit une prise en charge étendue de la mise en forme, qui est décrite plus en détail dans les rubriques de mise en forme suivantes :

• Pour plus d’informations sur les spécificateurs de format numérique, consultez Chaînes de format numérique standard et Chaînes de format numérique personnalisées.

• Pour plus d’informations sur la mise en forme, consultez Mise en forme des types.

Voir aussi

• Parse(String)
• Mettre en forme des types dans .NET
• Chaînes de format numériques standard

ToString(IFormatProvider)

Source:

Decimal.cs

Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente à l'aide des informations de format spécifiques à la culture donnée.

C#

public string ToString (IFormatProvider? provider);

Paramètres

provider

IFormatProvider

Objet qui fournit des informations de mise en forme propres à la culture.

Retours

String

Représentation sous forme de chaîne de la valeur de cette instance, comme indiqué par provider.

Implémente

ToString(IFormatProvider)

Exemples

L’exemple suivant affiche la représentation sous forme de chaîne d’une Decimal valeur à l’aide CultureInfo d’objets qui représentent plusieurs cultures différentes.

C#

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

Remarques

La ToString(IFormatProvider) méthode met en forme une Decimal valeur au format par défaut (« G » ou général) d’une culture spécifiée. Si vous souhaitez spécifier un autre format ou la culture actuelle, utilisez les autres surcharges de la ToString méthode, comme suit :

Pour utiliser le format	Pour la culture	Utiliser la surcharge
Format par défaut (« G »)	Culture par défaut (actuelle)	ToString()
Format spécifique	Culture par défaut (actuelle)	ToString(String)
Format spécifique	Une culture spécifique	ToString(String, IFormatProvider)

.NET fournit une prise en charge étendue de la mise en forme, qui est décrite plus en détail dans les rubriques de mise en forme suivantes :

• Pour plus d’informations sur les spécificateurs de format numérique, consultez Chaînes de format numérique standard et Chaînes de format numérique personnalisées.

• Pour plus d’informations sur la mise en forme, consultez Mise en forme des types.

Le provider paramètre est une IFormatProvider implémentation dont la IFormatProvider.GetFormat méthode retourne un NumberFormatInfo objet. En règle générale, provider est un NumberFormatInfo objet ou un CultureInfo objet. Le provider paramètre fournit des informations spécifiques à la culture utilisées dans la mise en forme. Si provider est null, la culture actuelle du thread est utilisée.

Pour convertir une Decimal valeur en sa représentation de chaîne à l’aide d’une culture spécifiée et d’une chaîne de format spécifique, appelez la Decimal.ToString(String, IFormatProvider) méthode .

Voir aussi

• Parse(String)
• Mettre en forme des types dans .NET
• Chaînes de format numériques standard

ToString(String)

Source:

Decimal.cs

Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente en utilisant le format spécifié.

C#

public string ToString (string? format);

Paramètres

format

String

Chaîne de format numérique standard ou personnalisée.

Retours

String

Représentation sous forme de chaîne de la valeur de cette instance, comme indiqué par format.

Exceptions

FormatException

format n'est pas valide.

Exemples

L’exemple suivant affiche une Decimal valeur à l’aide de chacun des spécificateurs de format numérique standard pris en charge, ainsi que de deux chaînes de format numérique personnalisées. Pour convertir les valeurs numériques en chaînes, l’exemple utilise les conventions de mise en forme de la culture en-US.

C#

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)

Remarques

La ToString(String) méthode met en forme une Decimal valeur dans un format spécifié à l’aide des conventions de la culture actuelle. Si vous souhaitez utiliser le format par défaut (« G », ou général) ou spécifier une autre culture, utilisez les autres surcharges de la ToString méthode, comme suit :

Pour utiliser le format	Pour la culture	Utiliser la surcharge
Format par défaut (« G »)	Culture par défaut (actuelle)	ToString()
Format par défaut (« G »)	Une culture spécifique	ToString(IFormatProvider)
Format spécifique	Une culture spécifique	ToString(String, IFormatProvider)

La ToString méthode utilise la chaîne de format numérique standard ou personnalisée spécifiée par le format paramètre pour convertir la valeur du instance actuel en sa représentation sous forme de chaîne. Le format paramètre peut être n’importe quel spécificateur de format numérique standard valide, à l’exception de D, R et X, ainsi que toute combinaison de spécificateurs de format numérique personnalisés. Si format est null ou une chaîne vide, la valeur de retour de cette instance est mise en forme avec le spécificateur de format numérique général (G).

.NET fournit une prise en charge étendue de la mise en forme, qui est décrite plus en détail dans les rubriques de mise en forme suivantes :

• Pour plus d’informations sur les spécificateurs de format numérique, consultez Chaînes de format numérique standard et Chaînes de format numérique personnalisées.

• Pour plus d’informations sur la mise en forme, consultez Mise en forme des types.

La valeur de retour est mise en forme à l’aide de l’objet NumberFormatInfo pour la culture actuelle. Pour appliquer les conventions de mise en forme d’une culture spécifiée, appelez la ToString(String, IFormatProvider) méthode .

Voir aussi

• Parse(String)
• Mettre en forme des types dans .NET
• Chaînes de format numériques standard
• Chaînes de format numérique personnalisées
• Comment : remplir un nombre avec des zéros non significatifs

ToString(String, IFormatProvider)

Source:

Decimal.cs

Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente à l'aide du format spécifié et des informations de format spécifiques à la culture.

C#

public string ToString (string? format, IFormatProvider? provider);

Paramètres

format

String

Chaîne de format numérique.

provider

IFormatProvider

Objet qui fournit des informations de mise en forme propres à la culture.

Retours

String

Représentation sous forme de chaîne de la valeur de cette instance, telle que spécifiée par format et provider.

Implémente

ToString(String, IFormatProvider)

Exceptions

FormatException

format n'est pas valide.

Exemples

L’exemple suivant affiche une Decimal valeur à l’aide de chacun des spécificateurs de format numérique standard pris en charge pour plusieurs cultures différentes.

C#

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 %

Remarques

La ToString(String, IFormatProvider) méthode met en forme une Decimal valeur dans un format spécifié d’une culture spécifiée. Si vous souhaitez utiliser les paramètres de format ou de culture par défaut, utilisez les autres surcharges de la ToString méthode, comme suit :

Pour utiliser le format	Pour la culture	Utiliser la surcharge
Format par défaut (« G »)	Culture par défaut (actuelle)	ToString()
Format par défaut (« G »)	Une culture spécifique	ToString(IFormatProvider)
Format spécifique	Culture par défaut (actuelle)	ToString(String)

Le format paramètre peut être n’importe quel spécificateur de format numérique standard valide, à l’exception de D, R et X, ainsi que toute combinaison de spécificateurs de format numérique personnalisés. Si format est null ou une chaîne vide, la valeur de retour de cette instance est mise en forme avec le spécificateur de format numérique général (« G »).

.NET fournit une prise en charge étendue de la mise en forme, qui est décrite plus en détail dans les rubriques de mise en forme suivantes :

• Pour plus d’informations sur les spécificateurs de format numérique, consultez Chaînes de format numérique standard et Chaînes de format numérique personnalisées.

• Pour plus d’informations sur la mise en forme, consultez Mise en forme des types.

Le provider paramètre est une IFormatProvider implémentation dont la IFormatProvider.GetFormat méthode retourne un NumberFormatInfo objet. En règle générale, provider est un NumberFormatInfo objet ou CultureInfo . Le provider paramètre fournit des informations spécifiques à la culture utilisées dans la mise en forme. Si provider est null, la culture actuelle du thread est utilisée.

Voir aussi

• Parse(String)
• Mettre en forme des types dans .NET
• Chaînes de format numériques standard
• Chaînes de format numérique personnalisées
• Comment : remplir un nombre avec des zéros non significatifs