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

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

Mise à jour : novembre 2007

Convertit la chaîne d'un nombre dans un format propre à la culture spécifiée en nombre à virgule flottante simple précision équivalent.

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

public static float Parse(
	string s,
	IFormatProvider provider
)
public static float Parse(
	String s,
	IFormatProvider provider
)
public static function Parse(
	s : String, 
	provider : IFormatProvider
) : float

Paramètres

s
Type : System.String
Chaîne représentant un nombre à convertir.
provider
Type : System.IFormatProvider
IFormatProvider qui fournit des informations de format propres à la culture concernant s.

Valeur de retour

Type : System.Single
Nombre à virgule flottante simple précision équivalant à la valeur numérique ou au symbole spécifié dans s.

ExceptionCondition
ArgumentNullException

s est null.

FormatException

s n'est pas un nombre au format valide.

OverflowException

s représente un nombre inférieur à MinValue ou supérieur à MaxValue.

En règle générale, cette surcharge permet de convertir du texte pouvant être mis en forme de différentes manières en valeur Single. 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 peut contenir PositiveInfinitySymbol, NegativeInfinitySymbol, NaNSymbol ou une chaîne se présentant comme suit :

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

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.

ws

Série d'espaces blancs.

signe

Symbole négatif ou positif.

chiffres intégraux

Série de chiffres spécifiant la partie intégrale du nombre. Des séquences de chiffres intégraux peuvent être partitionnées par un symbole séparateur de groupe. (Par exemple, dans certaines cultures, une virgule (,) sépare les groupes de milliers.) 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 majuscule ou minuscule, indiquant la notation (scientifique) exponentielle.

chiffres exponentiels

Série de chiffres spécifiant un exposant.

Voici quelques exemples de s : "100", "-123 456 789", "123.45e+6", "+500", "5e2", "3,1416", "600", "-0,123" et "-Infini".

Cette surcharge de Parse utilise les valeurs NumberStyles.Float et NumberStyles.AllowThousands ainsi que les informations sur le format numérique spécifiées par provider. Si provider a la valeurt null ou si NumberFormatInfo ne peut pas être obtenu, les informations de mise en forme relatives à la culture système en cours sont alors utilisées.

Pour plus d'informations sur les formats numériques, consultez la rubrique Vue d'ensemble des formats.

Si un séparateur est rencontré dans le paramètre s au cours d'une opération d'analyse et que la devise ou le nombre décimal applicables et les séparateurs de groupes sont identiques, l'opération d'analyse suppose que le séparateur est un séparateur décimal plutôt qu'un séparateur de groupes. Pour plus d'informations sur les séparateurs, consultez CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparator et NumberGroupSeparator.

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 Single.

protected void OkToSingle_Click(object sender, EventArgs e)
{
   string locale;
   float 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 = Single.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();
}


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