Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C#

NumberFormatInfo — pravidla formátování čísel

NumberFormatInfo poskytuje pravidla pro formátování a parsování čísel, včetně oddělovačů a symbolů měn. Seznamte se s hlavními metodami, rozdílem mezi aktuálním a invariantním nastavením a bezpečným vytvořením vlastní konfigurace.

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

Syntaxe

using System.Globalization;
NumberFormatInfo nfi = (NumberFormatInfo)NumberFormatInfo.InvariantInfo.Clone();
string text = value.ToString("N2", nfi);
NumberFormatInfo frozen = NumberFormatInfo.ReadOnly(nfi);

NumberFormatInfo z System.Globalization je IFormatProvider pro formátování a parsování čísel. Předávejte jej metodám, jako jsou decimal.ToString a decimal.Parse; sám neposkytuje metodu Parse ani číselnou metodu ToString. NumberDecimalSeparator a NumberGroupSeparator řídí formátování čísel; měny a procenta mají samostatné vlastnosti.

Mezi hlavní metody třídy NumberFormatInfo probírané v kurzu patří GetInstance, GetFormat, Clone a ReadOnly. GetInstance(provider) získá nastavení poskytovatele, a pokud je nedokáže získat, použije aktuální kulturu. Nezaručuje upravitelnou kopii. GetFormat(typeof(NumberFormatInfo)) vrátí aktuální objekt; pro jiný typ vrátí null.

Clone() vrátí zapisovatelnou kopii jako object, proto je nutné přetypování. ReadOnly(nfi) vrátí objekt pouze pro čtení — použijte vrácenou referenci. IsReadOnly tento stav oznámí; pokus o změnu vlastnosti takového objektu vyvolá InvalidOperationException. ReadOnly(null) vyvolá ArgumentNullException.

CurrentInfo závisí na aktuální kultuře. Pokud do CultureInfo.CurrentCulture přiřadíte upravitelný klon kultury, může CurrentInfo vrátit upravitelný objekt NumberFormatInfo tohoto klonu. InvariantInfo poskytuje pravidla nezávislá na kultuře a je pouze pro čtení. Příklad klonuje InvariantInfo, nastavuje oddělovače a používá "N2" pro seskupování se dvěma desetinnými místy. Parsování používá stejná pravidla spolu s NumberStyles.Number. Kód cílí na net10.0 a nevyžaduje jazykové funkce ve verzi preview.

Příklady

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

Výsledek

12_345,67
12345.67
True

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje