WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

Double.Parse – Text in double umwandeln

Double.Parse wandelt Text in einen double-Wert um. Die Kultur bestimmt die Trennzeichen, während NumberStyles die zulässige Syntax festlegt.

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

Syntax

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

Double.Parse gibt einen double zurück; double.Parse bezeichnet dieselbe Methode. Standardmäßig verwendet sie die aktuelle Kultur und NumberStyles.Float | NumberStyles.AllowThousands.

Mit CultureInfo.InvariantCulture als provider sind die Regeln für Trennzeichen unabhängig von den Systemeinstellungen. Die bloße Angabe eines provider garantiert das nicht: Eine CultureInfo kann benutzerdefinierte Einstellungen berücksichtigen. Liefert der provider keine NumberFormatInfo, verwendet die Methode die aktuelle Kultur. NumberStyles.Float erlaubt führende und nachgestellte Leerraumzeichen, ein führendes Vorzeichen, ein Dezimaltrennzeichen und einen Exponenten, jedoch keine Gruppentrennzeichen.

Bei Überladungen, die string entgegennehmen, führt null zu ArgumentNullException und eine fehlerhafte Eingabe zu FormatException. Ein ungültiger style führt zu ArgumentException. Verwende Double.TryParse, wenn Eingabefehler zu erwarten sind.

In .NET 10 ergibt ein Überlauf gewöhnlich PositiveInfinity oder NegativeInfinity, nicht OverflowException; Werte nahe der Grenze können zu einem endlichen Wert gerundet werden. Auch kulturspezifische Symbole für NaN und Unendlichkeit werden akzeptiert.

Beispiele

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

Ergebnis

125.00

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen