NumberFormatInfo.CurrencyGroupSizes Свойство

Определение

Возвращает или задает число цифр в каждой из групп целой части десятичной дроби в значениях денежных сумм.

C#
public int[] CurrencyGroupSizes { get; set; }

Значение свойства

Int32[]

Число цифр в каждой из групп целой части десятичной дроби в значениях денежных сумм. Для свойства InvariantInfo по умолчанию используется одномерный массив с единственным элементом, для которого задано значение 3.

Исключения

Для свойства задается значение null.

Для свойства задается значение, и массив содержит запись, которая меньше 0 или больше 9.

-или-

Для свойства задается значение, и массив содержит запись, отличную от последней записи, которая имеет значение 0.

Для свойства задается значение, а объект NumberFormatInfo доступен только для чтения.

Примеры

В следующем примере показан эффект изменения CurrencyGroupSizes свойства .

C#
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
*/

Комментарии

Свойство CurrencyGroupSizes используется со строкой стандартного формата "C", чтобы определить количество цифр, отображаемых в целочисленных группах. Дополнительные сведения см. в статье Строки стандартных числовых форматов. Каждый элемент в одномерном массиве должен быть целым числом от 1 до 9. Последний элемент может иметь значение 0.

Первый элемент массива определяет количество элементов в наименее значимой группе цифр, непосредственно слева от CurrencyDecimalSeparator. Каждый последующий элемент относится к следующей значительной группе цифр слева от предыдущей группы. Если последний элемент массива не равен 0, остальные цифры группируются по последнему элементу массива. Если последний элемент равен 0, остальные цифры не группируются.

Например, если массив содержит { 3, 4, 5 }, цифры группируются примерно так: "$55,55555,55555,55555,444,333,00". Если массив содержит { 3, 4, 0 }, цифры группируются примерно так: "$55555555555555555555,4444,333,00".

Применяется к

Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

См. также раздел