Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C#

Int32.Parse — converter texto em int

Int32.Parse converte texto numérico em int. Conheça as regras de formato predefinidas, a influência da cultura na análise e as exceções causadas por entradas inválidas.

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

Sintaxe

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

Int32.Parse é um método estático que devolve int, ou seja, System.Int32. Escrever int.Parse chama o mesmo método. O intervalo de valores vai de -2147483648 a 2147483647. As sobrecargas descritas estão disponíveis no .NET 10 e não requerem funcionalidades da linguagem preview.

Int32.Parse(string s) utiliza a cultura atual e NumberStyles.Integer: aceita algarismos decimais, um sinal inicial e espaços em branco no início ou no fim. Por predefinição, não aceita separadores de grupos nem separadores decimais. O parâmetro style determina os formatos permitidos, enquanto provider fornece as convenções culturais; null significa a cultura atual. Para analisar de forma previsível dados independentes da cultura, indique CultureInfo.InvariantCulture.

Nas sobrecargas que recebem cadeias de caracteres, null provoca ArgumentNullException, um formato inválido provoca FormatException e um valor fora do intervalo provoca OverflowException. Indicadores style inválidos provocam ArgumentException. Se forem esperadas entradas inválidas, escolha Int32.TryParse, que assinala uma conversão falhada com false.

O exemplo analisa " +42 " e, em seguida, interceta a exceção OverflowException lançada ao tentar converter "2147483648", cujo valor excede o limite máximo de int. Indicar explicitamente a cultura torna previsíveis tanto a análise como a saída.

Exemplos

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");
}

Resultado

42
OverflowException

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes