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

CKTIS / C#

Double.Parse — converter texto em double

Double.Parse converte texto em double. A cultura determina os separadores, enquanto NumberStyles controla a sintaxe permitida.

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

Sintaxe

double Double.Parse(string s)
double Double.Parse(string s, IFormatProvider? provider)
double Double.Parse(string s, NumberStyles style, IFormatProvider? provider)

Double.Parse devolve um double; double.Parse designa o mesmo método. Por predefinição, utiliza a cultura atual e NumberStyles.Float | NumberStyles.AllowThousands.

Ao utilizar CultureInfo.InvariantCulture como provider, as regras dos separadores não dependem das definições do sistema. Indicar explicitamente um provider não basta: uma instância de CultureInfo pode refletir as definições personalizadas pelo utilizador. Se o provider não fornecer um NumberFormatInfo, o método utiliza a cultura atual. NumberStyles.Float permite espaços em branco à volta do valor, um sinal inicial, um separador decimal e um expoente, mas não separadores de grupos.

Nas sobrecargas que aceitam string, null provoca ArgumentNullException e uma entrada mal formada provoca FormatException. Um style inválido provoca ArgumentException. Utilize Double.TryParse quando forem previsíveis erros de entrada.

No .NET 10, um overflow produz normalmente PositiveInfinity ou NegativeInfinity, não OverflowException; valores próximos do limite podem ser arredondados para um valor finito. Também são aceites os símbolos de NaN e infinito específicos da cultura.

Exemplos

using System;
using System.Globalization;

string text = " 1.25e2 ";
double value = Double.Parse(text, NumberStyles.Float, CultureInfo.InvariantCulture);
Console.WriteLine(value.ToString("F2", CultureInfo.InvariantCulture));

Resultado

125.00

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