CKTIS / C#
NumberFormatInfo — reguły zapisu liczb
NumberFormatInfo udostępnia reguły formatowania i parsowania liczb, np. separatory i symbole walut. Poznaj podstawowe metody, różnicę między ustawieniami bieżącymi a niezmiennymi oraz bezpieczne tworzenie własnej konfiguracji.
Wersja: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Składnia
using System.Globalization;
NumberFormatInfo nfi = (NumberFormatInfo)NumberFormatInfo.InvariantInfo.Clone();
string text = value.ToString("N2", nfi);
NumberFormatInfo frozen = NumberFormatInfo.ReadOnly(nfi);NumberFormatInfo z System.Globalization jest dostawcą IFormatProvider dla formatowania i parsowania liczb. Przekazujesz go do metod takich jak decimal.ToString i decimal.Parse; sam nie udostępnia metod Parse ani liczbowego ToString. NumberDecimalSeparator i NumberGroupSeparator sterują zapisem liczbowym; waluty i procenty mają osobne właściwości.
Podstawowe metody NumberFormatInfo omawiane w kursie to GetInstance, GetFormat, Clone i ReadOnly. GetInstance(provider) pobiera ustawienia dostawcy, a gdy nie może ich uzyskać, używa ustawień bieżącej kultury. Nie gwarantuje kopii do edycji. GetFormat(typeof(NumberFormatInfo)) zwraca bieżący obiekt; dla innego typu zwraca null.
Clone() zwraca zapisywalną kopię jako object, dlatego potrzebne jest rzutowanie. ReadOnly(nfi) zwraca obiekt tylko do odczytu — używaj zwróconej referencji. IsReadOnly informuje o tym stanie; próba zmiany właściwości takiego obiektu powoduje InvalidOperationException. ReadOnly(null) powoduje ArgumentNullException.
CurrentInfo zależy od bieżącej kultury. Jeśli do CultureInfo.CurrentCulture przypiszesz modyfikowalny klon kultury, CurrentInfo może zwrócić modyfikowalny obiekt NumberFormatInfo tego klonu. InvariantInfo zapewnia reguły niezależne od kultury i jest tylko do odczytu. Przykład klonuje InvariantInfo, ustawia separatory i używa "N2" do grupowania z dwoma miejscami po separatorze dziesiętnym. Parsowanie korzysta z tych samych reguł oraz NumberStyles.Number. Kod jest przeznaczony dla net10.0 i nie wymaga funkcji języka w wersji preview.
Przykłady
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);Wynik
12_345,67 12345.67 True
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.
Źródła
- 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