KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C#

NumberFormatInfo — regels voor getalnotatie

NumberFormatInfo levert regels voor het opmaken en parsen van getallen, waaronder scheidingstekens en valutasymbolen. Leer de belangrijkste methoden, het verschil tussen huidige en invariantinstellingen en hoe u veilig een eigen configuratie maakt.

Versie: .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 in System.Globalization is een IFormatProvider voor het opmaken en parsen van getallen. Geef het door aan methoden zoals decimal.ToString en decimal.Parse; het biedt zelf geen Parse- of numerieke ToString-methode. NumberDecimalSeparator en NumberGroupSeparator bepalen de getalnotatie; voor valuta en percentages bestaan aparte eigenschappen.

De belangrijkste methoden van NumberFormatInfo die in de cursus aan bod komen, zijn GetInstance, GetFormat, Clone en ReadOnly. GetInstance(provider) haalt de instellingen van de provider op en valt terug op de huidige cultuur als dat niet lukt. Een bewerkbare kopie is niet gegarandeerd. GetFormat(typeof(NumberFormatInfo)) retourneert het huidige object; voor een ander type retourneert het null.

Clone() retourneert een schrijfbare kopie als object, dus is een cast nodig. ReadOnly(nfi) retourneert een alleen-lezenobject — gebruik de geretourneerde verwijzing. IsReadOnly geeft deze status aan; een eigenschap van zo’n object proberen te wijzigen veroorzaakt InvalidOperationException. ReadOnly(null) veroorzaakt ArgumentNullException.

CurrentInfo hangt af van de huidige cultuur. Als u aan CultureInfo.CurrentCulture een schrijfbare kloon van een cultuur toewijst, kan CurrentInfo het schrijfbare NumberFormatInfo-object van die kloon retourneren. InvariantInfo levert cultuuronafhankelijke regels en is alleen-lezen. Het voorbeeld kloont InvariantInfo, stelt scheidingstekens in en gebruikt "N2" voor groepering met twee decimalen. Het parsen gebruikt dezelfde regels samen met NumberStyles.Number. De code is bedoeld voor net10.0 en vereist geen previewtaalfuncties.

Voorbeelden

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

Resultaat

12_345,67
12345.67
True

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen