Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. |
Traduction
Source
|
Int32.ToString, méthode (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é.
Assembly : mscorlib (dans mscorlib.dll)
Paramètres
- format
- Type : System.String
Chaîne de format numérique standard ou personnalisée.
Valeur de retour
Type : System.StringReprésentation sous forme de chaîne de la valeur de cette instance, telle que spécifiée par format.
| Exception | Condition |
|---|---|
| FormatException |
format n'est pas valide ou n'est pas pris en charge. |
Le paramètre format peut être tout spécificateur de format numérique standard valide, à l'exception de "R", ainsi que toute combinaison de spécificateurs de format numérique personnalisé. 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").
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 :
-
Pour plus d'informations sur les spécificateurs de format numérique, consultez Chaînes de format numériques standard et Chaînes de format numériques personnalisées.
-
Pour plus d'informations sur la mise en forme, consultez Mise en forme des types.
La valeur de retour de cette instance est mise en forme avec NumberFormatInfo pour la culture actuelle.
L'exemple suivant affiche une valeur Int32 qui utilise chacun des spécificateurs de format numérique standard pris en charge, ainsi que deux chaînes de format numérique personnalisé. Pour convertir les valeurs numériques en chaînes, l'exemple utilise les conventions de mise en forme de la culture en-US.
int value = -16325; string specifier; // Use standard numeric format specifier. specifier = "G"; Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier)); // Displays: G: -16325 specifier = "C"; Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier)); // Displays: C: ($16,325.00) specifier = "D8"; Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier)); // Displays: D8: -00016325 specifier = "E4"; Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier)); // Displays: E4: -1.6325E+004 specifier = "e3"; Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier)); // Displays: e3: -1.633e+004 specifier = "F"; Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier)); // Displays: F: -16325.00 specifier = "N"; Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier)); // Displays: N: -16,325.00 specifier = "P"; Console.WriteLine("{0}: {1}", specifier, (value/100000).ToString(specifier)); // Displays: P: -16.33 % specifier = "X"; Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier)); // Displays: X: FFFFC03B // Use custom numeric format specifiers. specifier = "0,0.000"; Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier)); // Displays: 0,0.000: -16,325.000 specifier = "#,#.00#;(#,#.00#)"; Console.WriteLine("{0}: {1}", specifier, (value*-1).ToString(specifier)); // Displays: #,#.00#;(#,#.00#): 16,325.00
Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2
Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Si vous souhaitez y participer,
