NumberFormatInfo.CurrencyGroupSizes NumberFormatInfo.CurrencyGroupSizes NumberFormatInfo.CurrencyGroupSizes NumberFormatInfo.CurrencyGroupSizes Property

Definicja

Pobiera lub ustawia liczbę cyfr w każdej grupie na lewo od liczby dziesiętnej w wartościach walutowych.Gets or sets the number of digits in each group to the left of the decimal in currency values.

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 z lewej strony dziesiętnej wartości walutowych.The number of digits in each group to the left of the decimal in currency values. Wartość domyślna dla InvariantInfo jest tablicą jednowymiarową z tylko jednym elementem, która jest ustawiona na 3.The default for InvariantInfo is a one-dimensional array with only one element, which is set to 3.

Wyjątki

Właściwość jest ustawiana na null.The property is being set to null.

Właściwość jest ustawiana i tablica zawiera wpis, który jest mniejszy niż 0 lub większy niż 9.The property is being set and the array contains an entry that is less than 0 or greater than 9.

—lub—-or-

Właściwość jest ustawiana i tablica zawiera wpis, inny niż ostatni wpis, ustawiony na wartość 0.The property is being set and the array contains an entry, other than the last entry, that is set to 0.

Właściwość jest ustawiana i NumberFormatInfo obiekt jest tylko do odczytu.The property is being set and the NumberFormatInfo object is read-only.

Przykłady

Poniższy przykład ilustruje efekt zmiany CurrencyGroupSizes właściwości.The following example demonstrates the effect of changing the CurrencyGroupSizes property.

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

CurrencyGroupSizes Właściwość jest używana z ciągiem formatu standardowego "C", aby zdefiniować liczbę cyfr, które pojawiają się w grupach całkowitych.The CurrencyGroupSizes property is used with the "C" standard format string to define the number of digits that appear in integral groups. Aby uzyskać więcej informacji, zobacz Standardowe ciągi formatująceliczby.For more information, see Standard Numeric Format Strings. Każdy element w tablicy jednowymiarowej musi być liczbą całkowitą z przedziału od 1 do 9.Every element in the one-dimensional array must be an integer from 1 through 9. Ostatni element może mieć wartość 0.The last element can be 0.

Pierwszy element tablicy definiuje liczbę elementów w najmniej znaczącej grupie cyfr bezpośrednio po lewej stronie CurrencyDecimalSeparator.The first element of the array defines the number of elements in the least significant group of digits immediately to the left of the CurrencyDecimalSeparator. Każdy kolejny element odnosi się do następnej znaczącej grupy cyfr z lewej strony poprzedniej grupy.Each subsequent element refers to the next significant group of digits to the left of the previous group. Jeśli ostatni element tablicy nie jest równy 0, pozostałe cyfry są pogrupowane na podstawie ostatniego elementu tablicy.If the last element of the array is not 0, the remaining digits are grouped based on the last element of the array. Jeśli ostatni element ma wartość 0, pozostałe cyfry nie są zgrupowane.If the last element is 0, the remaining digits are not grouped.

Na przykład, jeśli tablica zawiera {3, 4, 5}, cyfry są pogrupowane podobnie do "$ 55, 55555, 55555, 55555, 4444, 333.00".For example, if the array contains { 3, 4, 5 }, the digits are grouped similar to "$55,55555,55555,55555,4444,333.00". Jeśli tablica zawiera wartości {3, 4, 0}, cyfry są grupowane podobnie jak "$ 55555555555555555, 4444, 333.00".If the array contains { 3, 4, 0 }, the digits are grouped similar to "$55555555555555555,4444,333.00".

Dotyczy

Zobacz też