Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

Double.Parse — konwersja tekstu na double

Double.Parse przekształca tekst w double. Kultura określa separatory, a NumberStyles kontroluje dozwoloną składnię.

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

Składnia

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

Double.Parse zwraca wartość double; double.Parse oznacza tę samą metodę. Domyślnie używa bieżącej kultury oraz NumberStyles.Float | NumberStyles.AllowThousands.

Użycie CultureInfo.InvariantCulture jako provider uniezależnia reguły dotyczące separatorów od ustawień systemu. Samo jawne przekazanie provider tego nie gwarantuje: CultureInfo może uwzględniać ustawienia użytkownika, a jeśli provider nie dostarcza NumberFormatInfo, metoda korzysta z bieżącej kultury. NumberStyles.Float dopuszcza białe znaki na początku i na końcu, znak liczby na początku, separator dziesiętny i wykładnik, ale nie separatory grup cyfr.

Dla przeciążeń przyjmujących string, null powoduje ArgumentNullException, a błędny format — FormatException. Nieprawidłowy style powoduje ArgumentException. Przy oczekiwanych błędach danych użyj Double.TryParse.

W .NET 10 przepełnienie zwykle daje PositiveInfinity lub NegativeInfinity, nie OverflowException; wartości blisko granicy mogą zaokrąglić się do wartości skończonej. Akceptowane są także symbole NaN i nieskończoności właściwe dla kultury.

Przykłady

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

Wynik

125.00

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła