NumberFormatInfo.PercentGroupSizes プロパティ

.NET Framework クラス ライブラリ リファレンス

NumberFormatInfo.PercentGroupSizes プロパティ

パーセント値で小数点の左にある各グループの数字の数を取得または設定します。

名前空間: System.Globalization
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Property PercentGroupSizes As
 Integer()

Visual Basic (使用法)

Dim instance As NumberFormatInfo
Dim value As Integer()

value = instance.PercentGroupSizes

instance.PercentGroupSizes = value

C#

public int[] PercentGroupSizes { get;
 set; }

C++

public:
property array<int>^ PercentGroupSizes {
    array<int>^ get ();
    void set (array<int>^
 value);
}

J#

/** @property */
public int[] get_PercentGroupSizes ()

/** @property */
public void set_PercentGroupSizes (int[]
 value)

JScript

public function get PercentGroupSizes
 () : int[]

public function set PercentGroupSizes
 (value : int[])

プロパティ値
パーセント値で小数点の左にある各グループの数字の数。InvariantInfo の既定値は 1 つだけの要素を持つ 1 次元配列であり、その要素は 3 に設定されます。

例外

例外の種類	条件
ArgumentNullException	プロパティが null 参照 (Visual Basic では Nothing) に設定されています。
ArgumentException	プロパティが設定されており、配列に 0 よりも小さいか、9 よりも大きいエントリが格納されています。 または プロパティが設定されており、配列で最後のエントリ以外のエントリが 0 に設定されています。
InvalidOperationException	プロパティが設定されていますが、NumberFormatInfo が読み取り専用です。

解説

1 次元配列のすべての要素は、1 ～ 9 の間の整数にする必要があります。最後の要素は 0 にできます。

配列の最初の要素は、PercentDecimalSeparator のすぐ左にある、最も桁の小さい数字のグループの要素数を定義します。後続の各要素は、前のグループの左にある、次に桁の大きい数字のグループを参照します。配列の最後の要素が 0 ではない場合、残りの数字は配列の最後の要素に基づいてグループ化されます。最後の要素が 0 の場合、残りの数字はグループ化されません。

たとえば、配列が { 3, 4, 5 } を格納している場合、その数字は "$55,55555,55555,55555,4444,333.00%" のようにグループ化されます。配列が { 3, 4, 0 } を格納している場合、その数字は "$55555555555555555,4444,333.00%" のようにグループ化されます。

使用例

PercentGroupSizes プロパティの変更による影響を次のコード例に示します。

Visual Basic

Imports System
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 [Double] = 123456789012345.6789
      Console.WriteLine(myInt.ToString("P", nfi))

      ' Displays the same value with different groupings.
      Dim mySizes1 As Integer()
 =  {2, 3, 4}
      Dim mySizes2 As Integer()
 =  {2, 3, 0}
      nfi.PercentGroupSizes = mySizes1
      Console.WriteLine(myInt.ToString("P", nfi))
      nfi.PercentGroupSizes = mySizes2
      Console.WriteLine(myInt.ToString("P", nfi))

   End Sub 'Main 

End Class 'NumberFormatInfoSample


'This code produces the following output.

'

'12,345,678,901,234,600.00 %

'1234,5678,9012,346,00.00 %

'123456789012,346,00.00 %

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 (".").
      Double myInt = 123456789012345.6789;
      Console.WriteLine( myInt.ToString( "P", nfi ) );

      // Displays the same value with different groupings.
      int[] mySizes1 = {2,3,4};
      int[] mySizes2 = {2,3,0};
      nfi.PercentGroupSizes = mySizes1;
      Console.WriteLine( myInt.ToString( "P", nfi ) );
      nfi.PercentGroupSizes = mySizes2;
      Console.WriteLine( myInt.ToString( "P", nfi ) );

   }
}


/* 
This code produces the following output.

12,345,678,901,234,600.00 %
1234,5678,9012,346,00.00 %
123456789012,346,00.00 %
*/
   

C++

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".").
   Double myInt = 123456789012345.6789;
   Console::WriteLine( myInt.ToString( "P", nfi ) );
   
   // Displays the same value with different groupings.
   array<Int32>^mySizes1 = {2,3,4};
   array<Int32>^mySizes2 = {2,3,0};
   nfi->PercentGroupSizes = mySizes1;
   Console::WriteLine( myInt.ToString( "P", nfi ) );
   nfi->PercentGroupSizes = mySizes2;
   Console::WriteLine( myInt.ToString( "P", nfi ) );
}

/*
This code produces the following output.

12, 345, 678, 901, 234, 600.00 %
1234, 5678, 9012, 346, 00.00 %
123456789012, 346, 00.00 %
*/

J#

import System.*;
import System.Globalization.*;

class NumberFormatInfoSample
{
    public static void main(String[]
 args)
    {
        // Gets a NumberFormatInfo associated with the en-US culture.
        NumberFormatInfo nfi = (new CultureInfo("en-US",
 false)).
            get_NumberFormat();
        // Displays a value with the default separator (".").
        System.Double myInt = (System.Double)123456789012346L;
        Console.WriteLine(myInt.ToString("P", nfi));
        // Displays the same value with different groupings.
        int mySizes1[] =  { 2, 3, 4 };
        int mySizes2[] =  { 2, 3, 0 };
        nfi.set_PercentGroupSizes(mySizes1);
        Console.WriteLine(myInt.ToString("P", nfi));
        nfi.set_PercentGroupSizes(mySizes2);
        Console.WriteLine(myInt.ToString("P", nfi));
    } //main 
} //NumberFormatInfoSample

/* 
This code produces the following output.

12,345,678,901,234,600.00 %
1234,5678,9012,346,00.00 %
123456789012,346,00.00 %
*/

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
NumberFormatInfo クラス
NumberFormatInfo メンバ
System.Globalization 名前空間
NumberFormatInfo.PercentDecimalDigits プロパティ
NumberFormatInfo.PercentDecimalSeparator プロパティ
NumberFormatInfo.PercentGroupSeparator プロパティ
PercentSymbol
PercentNegativePattern
PercentPositivePattern
NumberFormatInfo.CurrencyGroupSizes プロパティ
NumberFormatInfo.NumberGroupSizes プロパティ