NumberFormatInfo.CurrencyGroupSizes Свойство

Определение

Пространство имен:

System.Globalization

Сборка:

System.Runtime.dll

Исходный код:

NumberFormatInfo.cs

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

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

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

Int32[]

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

Исключения

ArgumentNullException

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

ArgumentException

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

-или-

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

InvalidOperationException

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

Примеры

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

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

Комментарии

Свойство 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".

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

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