NumberFormatInfo.CurrencyGroupSizes Właściwość

Definicja

Przestrzeń nazw:

System.Globalization

Zestaw:

System.Runtime.dll

Źródło:

NumberFormatInfo.cs

Pobiera lub ustawia liczbę cyfr w każdej grupie po lewej stronie wartości dziesiętnych w walucie.

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

Wartość właściwości

Int32[]

Liczba cyfr w każdej grupie po lewej stronie wartości dziesiętnych w walucie. Wartość domyślna InvariantInfo to tablica jednowymiarowa z tylko jednym elementem, który jest ustawiony na wartość 3.

Wyjątki

ArgumentNullException

Właściwość jest ustawiana na null.

ArgumentException

Właściwość jest ustawiana, a tablica zawiera wpis mniejszy niż 0 lub większy niż 9.

-lub-

Właściwość jest ustawiana, a tablica zawiera wpis inny niż ostatni wpis ustawiony na wartość 0.

InvalidOperationException

Właściwość jest ustawiana, a NumberFormatInfo obiekt jest tylko do odczytu.

Przykłady

W poniższym przykładzie pokazano efekt zmiany CurrencyGroupSizes właściwości.

using namespace System;
using namespace System::Globalization;
int main()
{
   
   // Gets a NumberFormatInfo associated with the en-US culture.
   CultureInfo^ MyCI = gcnew CultureInfo( "en-US",false );
   NumberFormatInfo^ nfi = MyCI->NumberFormat;
   
   // Displays a value with the default separator (S".").
   Int64 myInt = 123456789012345;
   Console::WriteLine( myInt.ToString( "C", nfi ) );
   
   // Displays the same value with different groupings.
   array<Int32>^mySizes1 = {2,3,4};
   array<Int32>^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
*/

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

Uwagi

Właściwość CurrencyGroupSizes jest używana z ciągiem formatu standardowego "C", aby zdefiniować liczbę cyfr wyświetlanych w grupach całkowitych. Aby uzyskać więcej informacji, zobacz Standardowe ciągi formatu liczbowego. Każdy element w tablicy jednowymiarowej musi być liczbą całkowitą z zakresu od 1 do 9. Ostatni element może być 0.

Pierwszy element tablicy definiuje liczbę elementów w najmniej znaczącej grupie cyfr natychmiast po lewej CurrencyDecimalSeparatorstronie . Każdy kolejny element odnosi się do następnej znaczącej grupy cyfr po lewej stronie poprzedniej grupy. Jeśli ostatni element tablicy nie ma wartości 0, pozostałe cyfry są pogrupowane na podstawie ostatniego elementu tablicy. Jeśli ostatni element to 0, pozostałe cyfry nie są pogrupowane.

Jeśli na przykład tablica zawiera { 3, 4, 5 }, cyfry są zgrupowane podobnie do "$55,55555,55555,555555,4444,333.00". Jeśli tablica zawiera { 3, 4, 0 }, cyfry są zgrupowane podobnie do "$555555555555555555555555555,4444,333.00".

Zobacz też

• CurrencyDecimalDigits
• CurrencyDecimalSeparator
• CurrencyGroupSeparator
• CurrencySymbol
• CurrencyNegativePattern
• CurrencyPositivePattern
• NumberGroupSizes
• PercentGroupSizes