C# - A NumberFormatInfo osztály bemutatása

A .NET készítői a System.Globalization névtérbe rendezték azokat osztályokat, melyek a kultúrához kötődő, nyelvi, ország/régió- vagy naptárinformációkat rendszereznek, illetve azokat, melyek meghatározzák, hogy az adott típusokat hogyan formázhatjuk.

A NumberFormatInfo osztály lehetővé teszi a numerikus értékek formázását és megjelenítését attól függően, hogy milyen kultúrával kapcsolatos információkat adtunk meg paraméterként. Általánosságban elmondható, hogy az alapvető formázókarakterek használatát egészíti ki.

Tulajdonságainak tanulmányozása után elmondható, hogy alapvetően háromféle számérték megjelenítése válhat színesebbé ezen osztály felhasználásával: a pénzértékek, általános számértékek és a számértékek megjelenítése. Egy-egy property alapértelmezett értékének megváltoztatásával ugyanis befolyásolható akár a megjelenített értékhez kapcsolódó szimbólum is. A tulajdonságok rendre a következők:

CurrentInfo

Osztály: NumberFormatInfo

public static NumberFormatInfo CurrentInfo {get;}

Visszaad egy csak olvasható példányt az adott osztályból, melynek property-jei a CultureInfo osztályban megadott tulajdonságokkal rendelkeznek, az aktuális kultúrára vonatkozó információkkal feltöltve.

InvariantInfo

Osztály: NumberFormatInfo

public static NumberFormatInfo InvariantInfo {get;}

Visszaad egy csak olvasható példányt az adott osztályból, melynek property-jei kultúra-független információkat tartalmaznak.

NaNSymbol

Osztály: NumberFormatInfo

public string NaNSymbol {get; set;}

Megadható, hogy mit szeretnénk látni az IEEE szabványos NaN (not a number) szimbóluma helyett.

NegativeInfinitySymbol

Osztály: NumberFormatInfo

public string NegativeInfinitySymbol {get; set;}

Megadható a negatív végtelen szimbóluma. Alapértelmezett értéke „-Infinity”.

PositiveInfinitySymbol

Osztály: NumberFormatInfo

public string PositiveInfinitySymbol {get; set;}

Megadható a pozitív végtelen szimbóluma. Alapértelmezett értéke „Infinity”.

NegativeSign

Osztály: NumberFormatInfo

public string NegativeSign {get; set;}

A negatív számokat jelző szimbólum értéke. Alapértelmezett a „-” jel.

PositiveSign

Osztály: NumberFormatInfo

public string PositiveSign {get; set;}

A pozitív számokat jelző szimbólum értéke. Alapértelmezett a „+” jel.

Pénzértékeket formázó property-k

CurrencyDecimalDigits

Osztály: NumberFormatInfo

public int CurrencyDecimalDigits {get; set;}

Megadható, hogy az adott pénznem váltópénze hány tizedesjegyen jelenjen meg. Alapértelmezett értéke 2.

CurrencyDecimalSeparator

Osztály: NumberFormatInfo

public string CurrencyDecimalSeparator {get; set;}

Megadható, hogy a pénzérték tizedesjegyeit milyen karakterlánc válassza el az egészektől. Alapértelmezett értéke „.”.

CurrencyGroupSeparator

Osztály: NumberFormatInfo

public string CurrencyGroupSeparator {get; set;}

Ha a pénzérték számjegyei csoportokba rendezettek, megadható, hogy az egyes csoportokat milyen karakterlánc válassza el egymástól. Alapértelmezett értéke „,”.

CurrencyGroupSizes

Osztály: NumberFormatInfo

public int[] CurrencyGroupSizes {get; set;}

Egy egészeket tartalmazó tömbbel megadható, hogy a számjegyek milyen méretű csoportokban legyenek megjelenítve. A {5,4,3} értékeket tartalmazó tömböt értékül adva a property-nek a következő megjelenítés érhető el: „100.0000.00000”. A tömb elemei 0 és 9 közti egészek.

CurrencyNegativePattern

Osztály: NumberFormatInfo

public int CurrencyNegativePattern {get; set;}

Megadható, hogy milyen legyen a számérték megjelenítése, ha a szám negatív. 16 különböző variációja van, az alapértelmezett érték 0, mely a következő megjelenítést teszi lehetővé: „(Ft n)”, ahol n a számérték. A mellékelt programban valamennyi megjelenítés kipróbálható.

Érték	Minta
0	(Ft n)
1	-Ft n
2	Ft- n
3	Ft n -
4	( n Ft)
5	- n Ft
6	n –Ft
7	n Ft-
8	- n Ft
9	-Ft n
10	n Ft-
11	Ft n -
12	Ft - n
13	n – Ft
14	(Ft n)
15	( n Ft)

CurrencyPositivePattern

Osztály: NumberFormatInfo

public int CurrencyPositivePattern {get; set;}

Megadható, hogy milyen legyen a számérték megjelenítése, ha a szám pozitív. 4 különböző variációja van, az alapértelmezett érték 0, mely a következő megjelenítést teszi lehetővé: „Ft n”, ahol n a számérték. A mellékelt programban valamennyi megjelenítés kipróbálható.

Érték	Minta
0	Ft n
1	n Ft
2	Ft n
3	n Ft

CurrencySymbol

Osztály: NumberFormatInfo

public string CurrencySymbol {get; set;}

Megadható a használni kívánt pénznem szimbóluma. Alapértelmezett értéke a „$”.

Számokat formázó property-k

NumberDecimalDigits

Osztály: NumberFormatInfo

public int NumberDecimalDigits {get; set;}

Megadható, hogy a számértékek tizedesjegyei hány helyiértéken jelenjenek meg. Alapértelmezett értéke 2.

NumberDecimalSeparator

Osztály: NumberFormatInfo

public string NumberDecimalSeparator {get; set;}

Megadható, hogy a számérték tizedesjegyeit milyen karakterlánc válassza el az egészektől. Alapértelmezett értéke „.”.

NumberGroupSeparator

Osztály: NumberFormatInfo

public string NumberGroupSeparator {get; set;}

Ha a számérték számjegyei csoportokba rendezettek, megadható, hogy az egyes csoportokat milyen karakterlánc válassza el egymástól. Alapértelmezett értéke „,”.

NumberGroupSizes

Osztály: NumberFormatInfo

public int[] NumberGroupSizes {get; set;}

NumberNegativePattern

Osztály: NumberFormatInfo

public int NumberNegativePattern {get; set;}

Megadható, hogy milyen legyen a számérték megjelenítése, ha a szám negatív. 5 különböző variációja van, az alapértelmezett érték 0, mely a következő megjelenítést teszi lehetővé: „( n)”, ahol n a számérték. A mellékelt programban valamennyi megjelenítés kipróbálható.

Értékek	Minta
0	( n)
1	- n
2	- n
3	n -
4	n -

Százalékos értékeket formázó property-k

A százalékos értékek property-jei megfelelnek a számértékeket és pénzértékeket formázó property-knek azzal az eltéréssel, hogy a megfelelő property neve a „Percent” szócskával kezdődik. A különbség mindössze egy property-ben van:

PercentSymbol

Osztály: NumberFormatInfo

public string PercentSymbol {get; set;}

Megadható, hogy mit szeretnénk látni százalékos szimbólumként. Alapértelmezett értéke „%”.

A mellékelt példaprogramban a „Number”, illetve „Currency” szavakkal kezdődő property-ket próbálhatjuk ki. Az alkalmazás Form-ján külön csoportban vannak azok a property-k, melyek csak nevükben különböznek a két kategóriában, és külön csoportban azok, melyek csak a pénzérték formázását teszik lehetővé. A csoportok külön GroupBox-ban vannak.

A „ShowedText” felirat melletti TextBox kontrolban meg kell adni, milyen számot szeretnénk látni és alatta a „FormatString” listából ki kell választani, hogy milyen legyen a formázókarakter. Az említett property-csoportok értelemszerűen csak „C”, valamint „N” formázókarakter választása esetén használhatók.

A property-csoportok szerkesztőmezőiben, illetve ComboBox kontroljaiban megadva, illetve kiválasztva a megfelelő értéket, a „Format” gombra kattintva az eredmény megjelenik a panel felső harmadában elhelyezett téglalapban.