Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

Int32.ToString, méthode (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.

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

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)

ExceptionCondition
FormatException

format n'est pas valide ou n'est pas pris en charge.

La méthode d'ToString(String, IFormatProvider) formate une valeur d'Int32 dans un format spécifié en utilisant l'objet d'NumberFormatInfo d'une culture spécifiée. Si vous souhaitez utiliser le format par défaut ou les paramètres de culture, utilisez les autres surcharges de la méthode d'ToString, comme suit :

Pour utiliser le format

Pour la culture

Utilisez la surcharge

Comptes correspondent par défaut (« G ») format

Culture par défaut (objet)

ToString()

Comptes correspondent par défaut (« G ») format

Une culture spécifique

ToString(IFormatProvider)

Un format spécifique

Culture par défaut (objet)

ToString(String)

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 :

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.


// 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


.NET Framework

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

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Bibliothèque de classes portable

Pris en charge dans : Bibliothèque de classes portable

.NET pour les applications du Windows Store

Pris en charge dans : Windows 8

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

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.

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft