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

定義

通貨の値で小数点の左にある各グループの数字の数を取得または設定します。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()

プロパティ値

Int32[]

通貨の値で小数点の左にある各グループの数字の数。The number of digits in each group to the left of the decimal in currency values. InvariantInfo の既定値は 1 つだけの要素を持つ 1 次元配列であり、その要素は 3 に設定されます。The default for InvariantInfo is a one-dimensional array with only one element, which is set to 3.

例外

プロパティが null に設定されています。The property is being set to null.

プロパティが設定され、配列には 0 より小さいか、9 よりも大きいエントリが含まれています。The property is being set and the array contains an entry that is less than 0 or greater than 9.

または-or-

プロパティが設定され、配列には 0 に設定されているエントリ (最後のエントリ以外) が含まれています。The property is being set and the array contains an entry, other than the last entry, that is set to 0.

このプロパティが設定されていますが、NumberFormatInfo オブジェクトは読み取り専用です。The property is being set and the NumberFormatInfo object is read-only.

次の例は、プロパティをCurrencyGroupSizes変更した場合の影響を示しています。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 'NumberFormatInfoSample

 

'This code produces the following output.

'

'$123,456,789,012,345.00

'$12,3456,7890,123,45.00

'$1234567890,123,45.00


注釈

"C" 標準書式指定文字列と共にプロパティを使用して、整数グループに出現する桁数を定義します。CurrencyGroupSizesThe CurrencyGroupSizes property is used with the "C" standard format string to define the number of digits that appear in integral groups. 詳細については、「標準の数値書式指定文字列」を参照してください。For more information, see Standard Numeric Format Strings. 1次元配列のすべての要素は、1 ~ 9 の整数である必要があります。Every element in the one-dimensional array must be an integer from 1 through 9. 最後の要素には0を指定できます。The last element can be 0.

配列の最初の要素は、 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. 後続の各要素は、前のグループの左側にある次の重要な数字のグループを参照します。Each subsequent element refers to the next significant group of digits to the left of the previous group. 配列の最後の要素が0でない場合、残りの数字は配列の最後の要素に基づいてグループ化されます。If the last element of the array is not 0, the remaining digits are grouped based on the last element of the array. 最後の要素が0の場合、残りの桁はグループ化されません。If the last element is 0, the remaining digits are not grouped.

たとえば、配列に {3, 4, 5} が含まれている場合、数字は "$ 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". 配列に {3, 4, 0} が含まれている場合、数字は "$ 55555555555555555, 4444, 333.00" のようにグループ化されます。If the array contains { 3, 4, 0 }, the digits are grouped similar to "$55555555555555555,4444,333.00".

適用対象

こちらもご覧ください