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

Ce sujet n'a pas encore été évalué - Évaluez ce sujet

Int32.ToString, méthode (String, IFormatProvider)

.NET Framework 4

Autres versions

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

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

Syntaxe

C++

Copier

public string ToString(
	string format,
	IFormatProvider provider
)

Paramètres

format: Type : System.String
Chaîne de format numérique standard ou personnalisée.

provider: Type : System.IFormatProvider
Objet qui fournit des informations de mise en forme spécifiques à la culture.

Valeur de retour

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

Implémentations

IFormattable.ToString(String, IFormatProvider)

Exceptions

Exception	Condition
FormatException	format n'est pas valide ou n'est pas pris en charge.

Notes

Le paramètre format peut être une chaîne de format numérique standard ou personnalisée. Toutes les chaînes de format numériques standard autres que "R" (ou "r") sont prises en charge, ainsi que tous les caractères de format numériques personnalisés. Si format est null ou une chaîne vide (""), la valeur de retour de cette instance est mise en forme à l'aide du spécificateur de format numérique général ("G").

Le paramètre provider est un objet qui implémente l'interface IFormatProvider. Sa méthode GetFormat retourne un objet NumberFormatInfo qui fournit des informations de mise en forme spécifiques à la culture sur le format de la chaîne retournée par la méthode. L'objet qui implémente IFormatProvider peut être l'un des objets suivants :

Objet CultureInfo représentant la culture dont les règles de mise en forme doivent être utilisées.
Objet NumberFormatInfo contenant les informations de mise en forme des nombres spécifiques pour cette valeur.
Objet personnalisé qui implémente IFormatProvider et dont la méthode GetFormat retourne un objet NumberFormatInfo qui fournit des informations de mise en forme.

Si provider est null ou si un objet NumberFormatInfo ne peut pas être obtenu de provider, la valeur de retour pour cette instance est mise en forme avec les NumberFormatInfo de la culture actuelle.

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.

Exemples

L'exemple suivant affiche une valeur positive et une valeur négative qui utilisent chacun des spécificateurs de format numérique standard pris en charge pour trois cultures différentes.

Copier


// Define cultures whose formatting conventions are to be used.
CultureInfo[] cultures = {CultureInfo.CreateSpecificCulture("en-US"), 
                          CultureInfo.CreateSpecificCulture("fr-FR"), 
                          CultureInfo.CreateSpecificCulture("es-ES") };
int positiveNumber = 1679;
int negativeNumber = -3045;
string[] specifiers = {"G", "C", "D8", "E2", "F", "N", "P", "X8"}; 

foreach (string specifier in specifiers)
{
   foreach (CultureInfo culture in cultures)
   {
      // Display values with "G" format specifier.
      Console.WriteLine("{0} format using {1} culture: {2, 16} {3, 16}",  
                        specifier, culture.Name, 
                        positiveNumber.ToString(specifier, culture), 
                        negativeNumber.ToString(specifier, culture));
   }
   Console.WriteLine();
}
// The example displays the following output:
//       G format using en-US culture:             1679            -3045
//       G format using fr-FR culture:             1679            -3045
//       G format using es-ES culture:             1679            -3045
//       
//       C format using en-US culture:        $1,679.00      ($3,045.00)
//       C format using fr-FR culture:       1 679,00 €      -3 045,00 €
//       C format using es-ES culture:       1.679,00 €      -3.045,00 €
//       
//       D8 format using en-US culture:         00001679        -00003045
//       D8 format using fr-FR culture:         00001679        -00003045
//       D8 format using es-ES culture:         00001679        -00003045
//       
//       E2 format using en-US culture:        1.68E+003       -3.05E+003
//       E2 format using fr-FR culture:        1,68E+003       -3,05E+003
//       E2 format using es-ES culture:        1,68E+003       -3,05E+003
//       
//       F format using en-US culture:          1679.00         -3045.00
//       F format using fr-FR culture:          1679,00         -3045,00
//       F format using es-ES culture:          1679,00         -3045,00
//       
//       N format using en-US culture:         1,679.00        -3,045.00
//       N format using fr-FR culture:         1 679,00        -3 045,00
//       N format using es-ES culture:         1.679,00        -3.045,00
//       
//       P format using en-US culture:     167,900.00 %    -304,500.00 %
//       P format using fr-FR culture:     167 900,00 %    -304 500,00 %
//       P format using es-ES culture:     167.900,00 %    -304.500,00 %
//       
//       X8 format using en-US culture:         0000068F         FFFFF41B
//       X8 format using fr-FR culture:         0000068F         FFFFF41B
//       X8 format using es-ES culture:         0000068F         FFFFF41B

Informations de version

.NET Framework

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

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Pris en charge dans :

Plateformes

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.

Voir aussi