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
TryParse, méthode (String, NumberStyles, IFormatProvider, Int64)
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

Int64.TryParse, méthode (String, NumberStyles, IFormatProvider, Int64)

Convertit la chaîne d'un nombre dans un style et un format propre à une culture spécifiés en entier 64 bits signé équivalent. Une valeur de retour indique si la conversion a réussi ou a échoué.

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

public static bool TryParse(
	string s,
	NumberStyles style,
	IFormatProvider provider,
	out long result
)

Paramètres

s
Type : System.String
Chaîne contenant un nombre à convertir. La chaîne est interprétée à l'aide du style spécifié par style.
style
Type : System.Globalization.NumberStyles
Combinaison de bits de valeurs d'énumération qui indique les éléments de style pouvant être présents dans s. Une valeur typique à spécifier est NumberStyles.Integer.
provider
Type : System.IFormatProvider
Objet qui fournit des informations de mise en forme propres à la culture sur s.
result
Type : System.Int64
Lorsque cette méthode est retournée, contient la valeur de l'entier signé 64 bits équivalente au nombre contenu dans s si la conversion a réussi, ou zéro si elle a échoué. La conversion échoue si le paramètre s est null ou String.Empty, qu'il n'est pas dans un format conforme à style ou qu'il représente un nombre inférieur à MinValue ou supérieur à MaxValue. Ce paramètre est passé sans être initialisé.

Valeur de retour

Type : System.Boolean
true si la conversion de s a réussi ; sinon, false.

ExceptionCondition
ArgumentException

style n'est pas une valeur NumberStyles.

ou

style n'est pas une combinaison de valeurs AllowHexSpecifier et HexNumber.

La méthode TryParse ressemble à la méthode Parse, à la différence près que la méthode TryParse ne lève pas d'exception en cas d'échec de la conversion. Elle élimine le besoin de recourir à la gestion des exceptions pour tester une FormatException dans le cas où s n'est pas valide et ne peut être analysé correctement.

Le paramètre style définit les éléments de style (un espace blanc ou un signe positif ou négatif, par exemple) autorisés dans le paramètre s pour que l'opération d'analyse réussisse. Il doit s'agir d'une combinaison de bits indicateurs issus de l'énumération NumberStyles. Selon la valeur de style, le paramètre s peut inclure les éléments suivants :

[ws][$][signe][chiffres,]chiffres[.chiffres_fractionnaires][e[signe]chiffres_exponentiels][ws]

Ou, si le paramètre style inclut NumberStyles.AllowHexSpecifier :

[ws]chiffreshex[ws]

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

Élément

Description

ws

Espace blanc facultatif. L'espace blanc peut apparaître au début de s si style inclut l'indicateur NumberStyles.AllowLeadingWhite, ou à la fin de s si style inclut l'indicateur NumberStyles.AllowTrailingWhite.

$

Symbole monétaire spécifique à la culture. Sa position dans la chaîne est définie par la propriété CurrencyPositivePattern de l'objet NumberFormatInfo retourné par la méthode GetFormat du paramètre provider. Le symbole monétaire peut apparaître dans s si style inclut l'indicateur NumberStyles.AllowCurrencySymbol.

sign

Signe facultatif. Un symbole peut apparaître dans s si style inclut l'indicateur NumberStyles.AllowLeadingSign ou les indicateurs NumberStyles.AllowTrailingSign.

chiffres

chiffres_fractionnaires

chiffres_exponentiels

Séquence de chiffres compris entre 0 et 9. Pour chiffres_fractionnaires, seul le chiffre 0 est valide.

,

Séparateur des milliers spécifique à la culture. Le séparateur des milliers de la culture spécifiée par provider peut apparaître dans s si style inclut l'indicateur NumberStyles.AllowThousands.

.

Symbole de séparateur décimal spécifique à la culture. Le symbole de virgule décimale de la culture spécifiée par provider peut apparaître dans s si style inclut l'indicateur NumberStyles.AllowDecimalPoint.

e

Caractère e ou E, qui indique que la valeur est représentée en notation exponentielle. Le paramètre s peut représenter un nombre en notation exponentielle si style inclut l'indicateur NumberStyles.AllowExponent.

chiffreshex

Séquence de chiffres hexadécimaux compris entre 0 et f, ou 0 et F.

Une chaîne contenant uniquement des chiffres décimaux (ce qui correspond à l'indicateur NumberStyles.None) est toujours analysée avec succès. La plupart des membres NumberStyles restants contrôlent des éléments qui peuvent être présents, sans que ce soit obligatoire, dans cette chaîne d'entrée. Le tableau suivant montre de quelle manière des membres NumberStyles individuels affectent les éléments qui peuvent être présents dans s.

Valeurs NumberStyles non composites

Éléments autorisés dans s en plus des chiffres

NumberStyles.None

Chiffres décimaux uniquement.

NumberStyles.AllowDecimalPoint

Virgule décimale (. ) et éléments chiffres_fractionnaires. Les chiffres_fractionnaires doivent toutefois contenir un ou plusieurs chiffres 0, sinon la méthode retourne la valeur false.

NumberStyles.AllowExponent

Le paramètre s peut également utiliser la notation exponentielle. Le paramètre s doit représenter un nombre entier dans la plage du type de données Int64 et ne peut comporter aucun composant différent de zéro et fractionnaire.

NumberStyles.AllowLeadingWhite

Élément ws au début de s.

NumberStyles.AllowTrailingWhite

Élément ws à la fin de s.

NumberStyles.AllowLeadingSign

Un signe peut apparaître avant des chiffres.

NumberStyles.AllowTrailingSign

Un signe peut apparaître après des chiffres.

NumberStyles.AllowParentheses

Élément signe sous la forme de parenthèses entourant la valeur numérique.

NumberStyles.AllowThousands

Élément de séparateur des milliers (,).

NumberStyles.AllowCurrencySymbol

Élément HTML $.

NumberStyles.Currency

Tous les éléments. Le paramètre s ne peut pas représenter un nombre hexadécimal ou un nombre en notation exponentielle.

NumberStyles.Float

Élément ws au début ou à la fin de s, signe au début de s et séparateur décimal (.) . Le paramètre s peut également utiliser la notation exponentielle.

NumberStyles.Number

Éléments ws, signe, séparateur des milliers (,) et séparateur décimal (.).

NumberStyles.Any

Tous les styles, à l'exception de s qui ne peut pas représenter un nombre hexadécimal.

Si l'indicateur NumberStyles.AllowHexSpecifier est utilisé, s doit être une valeur hexadécimale. Les seuls autres indicateurs qui peuvent être présents dans style sont NumberStyles.AllowLeadingWhite et NumberStyles.AllowTrailingWhite. (L'énumération NumberStyles a un style composite, NumberStyles.HexNumber, qui inclut les deux indicateurs d'espace blanc.)

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

L'exemple suivant appelle la méthode TryParse(String, NumberStyles, IFormatProvider, Int64) avec plusieurs valeurs de chaîne et NumberStyles différentes.


using System;
using System.Globalization;

public class StringParsing
{
   public static void Main()
   {
      string numericString;
      NumberStyles styles;

      numericString = "106779";
      styles = NumberStyles.Integer;
      CallTryParse(numericString, styles);

      numericString = "-30677";
      styles = NumberStyles.None;
      CallTryParse(numericString, styles);

      styles = NumberStyles.AllowLeadingSign;
      CallTryParse(numericString, styles);

      numericString = "301677-";
      CallTryParse(numericString, styles);

      styles = styles | NumberStyles.AllowTrailingSign;
      CallTryParse(numericString, styles);

      numericString = "$10634";
      styles = NumberStyles.Integer;
      CallTryParse(numericString, styles);

      styles = NumberStyles.Integer | NumberStyles.AllowCurrencySymbol;
      CallTryParse(numericString, styles);

      numericString = "10345.00";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);

      numericString = "10345.72";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);

      numericString = "22,593"; 
      styles = NumberStyles.Integer | NumberStyles.AllowThousands;
      CallTryParse(numericString, styles);

      numericString = "12E-01";
      styles = NumberStyles.Integer | NumberStyles.AllowExponent;
      CallTryParse(numericString, styles); 

      numericString = "12E03";
      CallTryParse(numericString, styles); 

      numericString = "80c1";
      CallTryParse(numericString, NumberStyles.HexNumber);

      numericString = "0x80C1";
      CallTryParse(numericString, NumberStyles.HexNumber);      
   }

   private static void CallTryParse(string stringToConvert, NumberStyles styles)
   {
      int number;
      CultureInfo provider;

      // If currency symbol is allowed, use en-US culture.
      if ((styles & NumberStyles.AllowCurrencySymbol) > 0)
         provider = new CultureInfo("en-US");
      else
         provider = CultureInfo.InvariantCulture;

      bool result = Int32.TryParse(stringToConvert, styles, 
                                   provider, out number);
      if (result)
         Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number);
      else
         Console.WriteLine("Attempted conversion of '{0}' failed.", 
                           Convert.ToString(stringToConvert));
   }
}
// The example displays the following output to the console:
//       Converted '106779' to 106779.
//       Attempted conversion of '-30677' failed.
//       Converted '-30677' to -30677.
//       Attempted conversion of '301677-' failed.
//       Converted '301677-' to -301677.
//       Attempted conversion of '$10634' failed.
//       Converted '$10634' to 10634.
//       Converted '10345.00' to 10345.
//       Attempted conversion of '10345.72' failed.
//       Converted '22,593' to 22593.
//       Attempted conversion of '12E-01' failed.
//       Converted '12E03' to 12000.
//       Converted '80c1' to 32961.
//       Attempted conversion of '0x80C1' failed.


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.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