Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C#

Int32.Parse — convertir du texte en int

Int32.Parse convertit un texte numérique en int. Découvrez les règles de format par défaut, l’influence de la culture sur l’analyse et les exceptions provoquées par une entrée invalide.

Version : .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntaxe

Int32.Parse(string s)
Int32.Parse(string s, System.Globalization.NumberStyles style, IFormatProvider? provider)

Int32.Parse est une méthode statique qui renvoie un int, c’est-à-dire un System.Int32. Écrire int.Parse appelle la même méthode. La plage de valeurs va de -2147483648 à 2147483647. Les surcharges décrites sont disponibles dans .NET 10 et ne nécessitent aucune fonctionnalité de langage en version preview.

Int32.Parse(string s) utilise la culture actuelle et NumberStyles.Integer : la méthode accepte les chiffres décimaux, un signe initial ainsi que les espaces au début ou à la fin. Par défaut, les séparateurs de groupes et les séparateurs décimaux ne sont pas acceptés. Le paramètre style détermine les formats autorisés, tandis que provider fournit les conventions culturelles ; null désigne la culture actuelle. Pour analyser de manière prévisible des données indépendantes de la culture, indiquez CultureInfo.InvariantCulture.

Pour les surcharges prenant une chaîne, null provoque ArgumentNullException, un format invalide provoque FormatException et une valeur hors plage provoque OverflowException. Des indicateurs style invalides provoquent ArgumentException. Si des entrées invalides sont prévisibles, choisissez Int32.TryParse, qui signale l’échec de la conversion avec false.

L’exemple analyse " +42 ", puis intercepte le dépassement de capacité causé par "2147483648". Une culture explicitement indiquée rend l’analyse et l’affichage prévisibles.

Exemples

using System;
using System.Globalization;

int value = Int32.Parse(" +42 ", NumberStyles.Integer, CultureInfo.InvariantCulture);
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture));

try
{
    Int32.Parse("2147483648", NumberStyles.Integer, CultureInfo.InvariantCulture);
}
catch (OverflowException)
{
    Console.WriteLine("OverflowException");
}

Résultat

42
OverflowException

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources