CKTIS / C#
Double.ToString — eine Zahl mit explizitem Formatprovider formatieren
Double.ToString(string, IFormatProvider) wandelt einen double-Wert in Text um und lässt Zahlenformat und Kulturregeln getrennt festlegen. Gibt die Methode GetFormat des Providers bei einer Anfrage nach NumberFormatInfo null zurück, werden die Regeln der aktuellen Kultur verwendet.
Version: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
public string ToString(string? format, IFormatProvider? provider);Double.ToString(string, IFormatProvider) gibt eine Textdarstellung eines double-Werts zurück. Der Parameter format bestimmt die Schreibweise, während provider Kulturregeln bereitstellt, üblicherweise über CultureInfo oder NumberFormatInfo.
ToString() verwendet "G" und die aktuelle Kultur. ToString(string) ändert nur das Format, während ToString(IFormatProvider) nur den Provider der Formatierungsregeln ändert. Bei der Überladung mit zwei Argumenten bedeutet ein null- oder leeres format "G"; ein null-provider bedeutet die aktuelle Kultur.
"F2" erzeugt zwei Ziffern nach dem Dezimaltrennzeichen, während "N2" zusätzlich Ziffern gruppiert. Die Formatierung kann den ausgegebenen Text runden, ändert aber nicht den gespeicherten Wert. In .NET 10 löst ein nicht unterstützter numerischer Formatbezeichner wie "D" bei endlichen double-Werten eine FormatException aus. Bei NaN sowie bei positiver und negativer Unendlichkeit gibt die Methode das entsprechende kulturspezifische Symbol zurück, bevor sie den Bezeichner prüft. Deshalb löst "D" bei diesen Werten keine Ausnahme aus.
Das Beispiel verwendet CultureInfo.InvariantCulture und eine Kopie ihrer Formatierungsregeln mit geändertem Dezimaltrennzeichen. So wird der Unterschied zwischen 1234.50 und 1234,50 gezeigt, ohne von den Regionseinstellungen des Computers abhängig zu sein.
Beispiele
using System;
using System.Globalization;
double value = 1234.5;
var commaFormat = (NumberFormatInfo)CultureInfo.InvariantCulture.NumberFormat.Clone();
commaFormat.NumberDecimalSeparator = ",";
Console.WriteLine(value.ToString("F2", CultureInfo.InvariantCulture));
Console.WriteLine(value.ToString("F2", commaFormat));Ergebnis
1234.50 1234,50
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.