WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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