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

Cette surcharge de la méthode Parse(String, IFormatProvider) est généralement utilisée pour convertir du texte qui peut être mis en forme de diverses manières en une valeur Int32. Par exemple, elle peut être utilisée pour convertir le texte entré par un utilisateur dans une zone de texte HTML en valeur numérique.

Le paramètre s contient un nombre ayant la forme suivante :

[ws][signe]chiffres[ws]

Les éléments entre crochets ([ et ]) sont facultatifs. Le tableau suivant décrit les différents éléments.

Le paramètre s est interprété à l'aide du style NumberStyles.Integer. Outre des chiffres décimaux, seuls les espaces de début et de fin accompagnés d'un signe de début sont autorisés. Pour définir explicitement les éléments de style qui peuvent être présents dans s, utilisez la méthode Int32.Parse(String, NumberStyles, IFormatProvider).

Le paramètre provider est une implémentation IFormatProvider, telle qu'un objet NumberFormatInfo ou CultureInfo. Le paramètre provider fournit des informations spécifiques à la culture sur le format de s. Si provider est null, l'objet NumberFormatInfo de la culture actuelle est utilisé.

L'exemple suivant illustre le gestionnaire d'événements du clic de bouton d'un formulaire Web. Il utilise le tableau retourné par la propriété HttpRequest.UserLanguages pour déterminer les paramètres régionaux de l'utilisateur. Il instancie ensuite un objet CultureInfo qui correspond à ces paramètres régionaux. L'objet NumberFormatInfo qui appartient à cet objet CultureInfo est ensuite passé à la méthode Parse(String, IFormatProvider) afin de convertir l'entrée de l'utilisateur en une valeur Int32.

protected void OkToInteger_Click(object sender, EventArgs e)
{
   string locale;
   int number;
   CultureInfo culture;

   // Return if string is empty
   if (String.IsNullOrEmpty(this.inputNumber.Text))
      return;

   // Get locale of web request to determine possible format of number
   if (Request.UserLanguages.Length == 0)
      return;
   locale = Request.UserLanguages[0];
   if (String.IsNullOrEmpty(locale))
      return;

  // Instantiate CultureInfo object for the user's locale
   culture = new CultureInfo(locale);

   // Convert user input from a string to a number
   try
   {
      number = Int32.Parse(this.inputNumber.Text, culture.NumberFormat);
   }
   catch (FormatException)
   {
      return;
   }
   catch (Exception)
   {
      return;
   }
   // Output number to label on web form
   this.outputNumber.Text = "Number is " + number.ToString();
}

.NET Framework

.NET Framework Client Profile

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

Référence

Autres ressources