NumberFormatInfo.CurrencyGroupSizes Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví počet číslic v každé skupině vlevo od desetinné čárky v hodnotách měny.
public:
property cli::array <int> ^ CurrencyGroupSizes { cli::array <int> ^ get(); void set(cli::array <int> ^ value); };
public int[] CurrencyGroupSizes { get; set; }
member this.CurrencyGroupSizes : int[] with get, set
Public Property CurrencyGroupSizes As Integer()
Hodnota vlastnosti
Počet číslic v každé skupině vlevo od desetinné čárky v hodnotách měny. Výchozí hodnota je InvariantInfo jednorozměrné pole s pouze jedním prvkem, který je nastaven na hodnotu 3.
Výjimky
Vlastnost je nastavena na nullhodnotu .
Vlastnost je nastavena a pole obsahuje položku, která je menší než 0 nebo větší než 9.
nebo
Vlastnost se nastavuje a pole obsahuje položku kromě poslední položky, která je nastavena na hodnotu 0.
Vlastnost je nastavena a NumberFormatInfo objekt je jen pro čtení.
Příklady
Následující příklad ukazuje účinek změny CurrencyGroupSizes vlastnosti.
using System;
using System.Globalization;
class NumberFormatInfoSample {
public static void Main() {
// Gets a NumberFormatInfo associated with the en-US culture.
NumberFormatInfo nfi = new CultureInfo( "en-US", false ).NumberFormat;
// Displays a value with the default separator (".").
Int64 myInt = 123456789012345;
Console.WriteLine( myInt.ToString( "C", nfi ) );
// Displays the same value with different groupings.
int[] mySizes1 = {2,3,4};
int[] mySizes2 = {2,3,0};
nfi.CurrencyGroupSizes = mySizes1;
Console.WriteLine( myInt.ToString( "C", nfi ) );
nfi.CurrencyGroupSizes = mySizes2;
Console.WriteLine( myInt.ToString( "C", nfi ) );
}
}
/*
This code produces the following output.
$123,456,789,012,345.00
$12,3456,7890,123,45.00
$1234567890,123,45.00
*/
Imports System.Globalization
Class NumberFormatInfoSample
Public Shared Sub Main()
' Gets a NumberFormatInfo associated with the en-US culture.
Dim nfi As NumberFormatInfo = New CultureInfo("en-US", False).NumberFormat
' Displays a value with the default separator (".").
Dim myInt As Int64 = 123456789012345
Console.WriteLine(myInt.ToString("C", nfi))
' Displays the same value with different groupings.
Dim mySizes1 As Integer() = {2, 3, 4}
Dim mySizes2 As Integer() = {2, 3, 0}
nfi.CurrencyGroupSizes = mySizes1
Console.WriteLine(myInt.ToString("C", nfi))
nfi.CurrencyGroupSizes = mySizes2
Console.WriteLine(myInt.ToString("C", nfi))
End Sub
End Class
'This code produces the following output.
'
'$123,456,789,012,345.00
'$12,3456,7890,123,45.00
'$1234567890,123,45.00
Poznámky
Vlastnost CurrencyGroupSizes se používá se standardním formátovacím řetězcem "C" k definování počtu číslic, které se zobrazují v integrálních skupinách. Další informace naleznete v tématu Standardní číselné formátovací řetězce. Každý prvek v jednorozměrném poli musí být celé číslo od 1 do 9. Poslední prvek může být 0.
První prvek pole definuje počet prvků v nejméně významné skupině číslic okamžitě vlevo od CurrencyDecimalSeparator. Každý další prvek odkazuje na další významnou skupinu číslic vlevo od předchozí skupiny. Pokud poslední prvek pole není 0, zbývající číslice jsou seskupeny na základě posledního prvku pole. Pokud je poslední prvek 0, zbývající číslice nejsou seskupené.
Pokud například matice obsahuje { 3, 4, 5 }, číslice jsou seskupeny podobně jako "\55 555555 555555 55555 4444 333,00". Pokud matice obsahuje { 3, 4, 0 }, číslice jsou seskupeny podobně jako "\$555555555555555555 4444,333,00".