Informations
Le sujet que vous avez demandé est indiqué ci-dessous. Toutefois, ce sujet ne figure pas dans la bibliothèque.

Single.ToString, méthode

Mise à jour : novembre 2007

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

Espace de noms :  System
Assembly :  mscorlib (dans mscorlib.dll)

public override string ToString()
public String ToString()
public override function ToString() : String

Valeur de retour

Type : System.String
Représentation sous forme de chaîne de la valeur de cette instance.

La valeur de retour peut être PositiveInfinitySymbol, NegativeInfinitySymbol, NaNSymbol ou une chaîne de la forme :

[signe]chiffres intégraux[.[chiffres fractionnaires]][e[signe]chiffres exponentiels]

Les éléments facultatifs sont encadrés par des crochets ([ et ]). Les éléments contenant le terme « digits » consistent en une série de caractères numériques compris entre 0 et 9.

signe

Symbole négatif ou positif.

chiffres intégraux

Série de chiffres spécifiant la partie intégrale du nombre. Les chiffres intégraux peuvent être absents s'il y a des chiffres fractionnaires.

'.'

Symbole de séparateur décimal spécifique à la culture.

chiffres fractionnaires

Série de chiffres spécifiant la partie fractionnaire du nombre.

'e'

Caractère 'e' en minuscule, indiquant la notation (scientifique) exponentielle.

chiffres exponentiels

Série de chiffres spécifiant un exposant.

Voici quelques exemples de la valeur de retour : "100", "-123 456 789", "123,45e+6", "500", "3,1416", "600", "-0,123" et "-Infini".

Cette surcharge de ToString utilise le spécificateur de format numérique général ("G") et le NumberFormatInfo de la culture en cours.

Le .NET Framework assure une prise en charge étendue de la mise en forme, décrite plus en détail dans les rubriques suivantes relatives à la mise en forme :

L'exemple de code suivant met en forme une valeur intégrale et une valeur numérique à virgule flottante en utilisant la culture actuelle du thread, une culture spécifiée et tous les spécificateurs de format numérique standard. Cet exemple de code utilise deux types numériques particuliers, mais produirait des résultats similaires pour n'importe lequel des types numériques de base (Byte, SByte, Int16, Int32, Int64, UInt16, UInt32, UInt64, Decimal, Single et Double).

using System;
using System.Globalization;
using System.Threading;

public class NumericFormats
{
   public static void Main()
   {
      // Display string representations of numbers for en-us culture
      CultureInfo ci = new CultureInfo("en-us");

      // Output floating point values
      double floating = 10761.937554;
      Console.WriteLine("C: {0}", 
              floating.ToString("C", ci));           // Displays "C: $10,761.94"
      Console.WriteLine("E: {0}", 
              floating.ToString("E03", ci));         // Displays "E: 1.076E+004"
      Console.WriteLine("F: {0}", 
              floating.ToString("F04", ci));         // Displays "F: 10761.9376"         
      Console.WriteLine("G: {0}",  
              floating.ToString("G", ci));           // Displays "G: 10761.937554"
      Console.WriteLine("N: {0}", 
              floating.ToString("N03", ci));         // Displays "N: 10,761.938"
      Console.WriteLine("P: {0}", 
              (floating/10000).ToString("P02", ci)); // Displays "P: 107.62 %"
      Console.WriteLine("R: {0}", 
              floating.ToString("R", ci));           // Displays "R: 10761.937554"            
      Console.WriteLine();

      // Output integral values
      int integral = 8395;
      Console.WriteLine("C: {0}", 
              integral.ToString("C", ci));           // Displays "C: $8,395.00"
      Console.WriteLine("D: {0}", 
              integral.ToString("D6", ci));          // Displays D: 008395"" 
      Console.WriteLine("E: {0}", 
              integral.ToString("E03", ci));         // Displays "E: 8.395E+003"
      Console.WriteLine("F: {0}", 
              integral.ToString("F01", ci));         // Displays "F: 8395.0"    
      Console.WriteLine("G: {0}",  
              integral.ToString("G", ci));           // Displays "G: 8395"
      Console.WriteLine("N: {0}", 
              integral.ToString("N01", ci));         // Displays "N: 8,395.0"
      Console.WriteLine("P: {0}", 
              (integral/10000).ToString("P02", ci)); // Displays "P: 83.95 %"
      Console.WriteLine("X: 0x{0}", 
              integral.ToString("X", ci));           // Displays "X: 0x20CB"
      Console.WriteLine();
   }
}


L'exemple de code suivant illustre la méthode ToString.

bool done = false;
string inp;
do
{
    Console.Write("Enter a real number: ");
    inp = Console.ReadLine();
    try
    {
        s = Single.Parse(inp);
        Console.WriteLine("You entered {0}.", s.ToString());
        done = true;
    }
    catch (FormatException)
    {
        Console.WriteLine("You did not enter a number.");
    }
    catch (Exception e)
    {
        Console.WriteLine("An exception occurred while parsing your response: {0}", e.ToString());
    }
} while (!done);


boolean done = false;
System.String inp;
do {
    Console.Write("Enter a real number: ");
    inp = Console.ReadLine();
    try {
        s = new Float(Float.parseFloat(inp));
        Console.WriteLine("You entered {0}.", s);
        done = true;
    }
    catch (FormatException exp) {
        Console.WriteLine("You did not enter a number.");
    }
    catch (System.Exception e) {
        Console.WriteLine("An exception occurred while parsing your"
            + " response: {0}", e.ToString());
    }
} while (!(done));


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile pour Smartphone, Windows Mobile pour Pocket PC, Xbox 360

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Pris en charge dans : 3.5, 2.0, 1.0

XNA Framework

Pris en charge dans : 2.0, 1.0

Ajouts de la communauté

Afficher:
© 2014 Microsoft