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
|
Int32.TryParse, méthode (String, Int32%)
Convertit la représentation sous forme de chaîne d'un nombre en entier signé 32 bits équivalent. Une valeur de retour indique si la conversion a réussi.
Assembly : mscorlib (dans mscorlib.dll)
Paramètres
- s
- Type : System.String
Chaîne contenant un nombre à convertir.
- result
- Type : System.Int32%
Lorsque cette méthode est retournée, contient la valeur de l'entier signé 32 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, n'est pas au format approprié ou représente un nombre inférieur à MinValue ou supérieur à MaxValue. Ce paramètre est passé sans être initialisé.
La méthode TryParse s'apparente à la méthode Parse, à la différence près que la méthode TryParse ne lève aucune exception en cas d'échec de la conversion. Elle supprime la nécessité d'utiliser la gestion des exceptions pour tester une FormatException dans le cas où s n'est pas valide et ne peut pas être analysé avec succès.
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.
|
Élément |
Description |
|---|---|
|
ws |
Espace blanc facultatif. |
|
sign |
Signe facultatif. |
|
chiffres |
Séquence de chiffres compris entre 0 et 9. |
Le paramètre s est interprété à l'aide du style NumberStyles.Integer. Outre les 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 et les informations de mise en forme spécifiques à la culture qui peuvent être présentes dans s, utilisez la méthode Int32.TryParse(String, NumberStyles, IFormatProvider, Int32).
Le paramètre s est analysé à l'aide des informations de mise en forme figurant dans un objet NumberFormatInfo initialisé pour la culture système en cours. Pour plus d'informations, consultez CurrentInfo.
Cette surcharge de la méthode TryParse interprète tous les chiffres dans le paramètre s comme des chiffres décimaux. Pour analyser la représentation sous forme de chaîne d'un nombre hexadécimal, appelez la surcharge Int32.TryParse(String, NumberStyles, IFormatProvider, Int32).
L'exemple suivant appelle la méthode Int32.TryParse(String, Int32) avec plusieurs valeurs de chaîne différentes.
using System; public class StringParsing { public static void Main() { TryToParse(null); TryToParse("160519"); TryToParse("9432.0"); TryToParse("16,667"); TryToParse(" -322 "); TryToParse("+4302"); TryToParse("(100);"); TryToParse("01FA"); } private static void TryToParse(string value) { int number; bool result = Int32.TryParse(value, out number); if (result) { Console.WriteLine("Converted '{0}' to {1}.", value, number); } else { if (value == null) value = ""; Console.WriteLine("Attempted conversion of '{0}' failed.", value); } } } // The example displays the following output to the console: // Attempted conversion of '' failed. // Converted '160519' to 160519. // Attempted conversion of '9432.0' failed. // Attempted conversion of '16,667' failed. // Converted ' -322 ' to -322. // Converted '+4302' to 4302. // Attempted conversion of '(100);' failed. // Attempted conversion of '01FA' failed.
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.