CKTIS / C#
NumberFormatInfo — Regeln für die Zahlenformatierung
NumberFormatInfo stellt Regeln zum Formatieren und Parsen von Zahlen bereit, etwa für Trennzeichen und Währungssymbole. Lernen Sie die wichtigsten Methoden, den Unterschied zwischen aktuellen und invarianten Einstellungen sowie das sichere Erstellen einer eigenen Konfiguration kennen.
Version: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
using System.Globalization;
NumberFormatInfo nfi = (NumberFormatInfo)NumberFormatInfo.InvariantInfo.Clone();
string text = value.ToString("N2", nfi);
NumberFormatInfo frozen = NumberFormatInfo.ReadOnly(nfi);NumberFormatInfo aus System.Globalization ist ein IFormatProvider für die Zahlenformatierung und das Parsen. Übergeben Sie es an Methoden wie decimal.ToString und decimal.Parse; die Klasse selbst stellt weder Parse noch eine numerische ToString-Methode bereit. NumberDecimalSeparator und NumberGroupSeparator steuern die Zahlenformatierung; für Währungen und Prozentwerte gibt es eigene Eigenschaften.
Zu den grundlegenden Methoden von NumberFormatInfo, die im Kurs behandelt werden, gehören GetInstance, GetFormat, Clone und ReadOnly. GetInstance(provider) ruft die Einstellungen des Anbieters ab und verwendet die aktuelle Kultur, wenn es diese nicht abrufen kann. Eine bearbeitbare Kopie wird dabei nicht garantiert. GetFormat(typeof(NumberFormatInfo)) gibt das aktuelle Objekt zurück; bei einem anderen Typ wird null zurückgegeben.
Clone() gibt eine beschreibbare Kopie als object zurück, daher ist eine Umwandlung erforderlich. ReadOnly(nfi) gibt ein schreibgeschütztes Objekt zurück — verwenden Sie die zurückgegebene Referenz. IsReadOnly zeigt diesen Zustand an; der Versuch, eine Eigenschaft eines solchen Objekts zu ändern, löst InvalidOperationException aus. ReadOnly(null) löst ArgumentNullException aus.
CurrentInfo hängt von der aktuellen Kultur ab. Wenn CultureInfo.CurrentCulture auf einen beschreibbaren Klon einer Kultur gesetzt wird, kann CurrentInfo das beschreibbare NumberFormatInfo-Objekt dieses Klons zurückgeben. InvariantInfo stellt kulturunabhängige Regeln bereit und ist schreibgeschützt. Das Beispiel klont InvariantInfo, legt Trennzeichen fest und verwendet "N2" für die Gruppierung mit zwei Nachkommastellen. Beim Parsen werden dieselben Regeln zusammen mit NumberStyles.Number verwendet. Der Code ist für net10.0 vorgesehen und benötigt keine Preview-Sprachfunktionen.
Beispiele
using System;
using System.Globalization;
NumberFormatInfo nfi = (NumberFormatInfo)NumberFormatInfo.InvariantInfo.Clone();
nfi.NumberDecimalSeparator = ",";
nfi.NumberGroupSeparator = "_";
nfi.NumberGroupSizes = new[] { 3 };
NumberFormatInfo frozen = NumberFormatInfo.ReadOnly(nfi);
string text = 12345.67m.ToString("N2", frozen);
Console.WriteLine(text);
decimal parsed = decimal.Parse(text, NumberStyles.Number, frozen);
Console.WriteLine(parsed.ToString("F2", CultureInfo.InvariantCulture));
Console.WriteLine(frozen.IsReadOnly);Ergebnis
12_345,67 12345.67 True
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
- NumberFormatInfo Class (System.Globalization) | Microsoft Learn
- NumberFormatInfo.GetInstance(IFormatProvider) Method (System.Globalization) | Microsoft Learn
- NumberFormatInfo.GetFormat(Type) Method (System.Globalization) | Microsoft Learn
- NumberFormatInfo.Clone Method (System.Globalization) | Microsoft Learn
- NumberFormatInfo.ReadOnly(NumberFormatInfo) Method (System.Globalization) | Microsoft Learn