NumberFormatInfo.NumberGroupSizes プロパティ
数値で小数点の左にある各グループの数字の数を取得または設定します。
Public Property NumberGroupSizes As Integer ()
[C#]
public int[] NumberGroupSizes {get; set;}
[C++]
public: __property int get_NumberGroupSizes();public: __property void set_NumberGroupSizes(int __gc[]);
[JScript]
public function get NumberGroupSizes() : int[];
public function set NumberGroupSizes(int[]);
プロパティ値
数値で小数点の左にある各グループの数字の数。 InvariantInfo の既定値は 1 つだけの要素を持つ 1 次元配列であり、その要素は 3 に設定されます。
例外
例外の種類 | 条件 |
---|---|
ArgumentNullException | プロパティが null 参照 (Visual Basic では Nothing) に設定されています。 |
ArgumentException | プロパティが設定されており、配列に 0 よりも小さいか、9 よりも大きいエントリが格納されています。
または プロパティが設定されており、配列で最後のエントリ以外のエントリが 0 に設定されています。 |
InvalidOperationException | プロパティが設定されていますが、 NumberFormatInfo が読み取り専用です。 |
解説
1 次元配列のすべての要素は、1 ~ 9 の間の整数にする必要があります。最後の要素は 0 にできます。
配列の最初の要素は、 NumberDecimalSeparator のすぐ左にある、最も桁の小さい数字のグループの要素数を定義します。後続の各要素は、前のグループの左にある、次に桁の大きい数字のグループを参照します。配列の最後の要素が 0 ではない場合、残りの数字は配列の最後の要素に基づいてグループ化されます。最後の要素が 0 の場合、残りの数字はグループ化されません。
たとえば、配列が { 3, 4, 5 } を格納している場合、その数字は "$55,55555,55555,55555,4444,333.00" のようにグループ化されます。配列が { 3, 4, 0 } を格納している場合、その数字は "$55555555555555555,4444,333.00" のようにグループ化されます。
使用例
[Visual Basic, C#, C++] NumberGroupSizes プロパティの変更による影響を次のコード例に示します。
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 Int64 = 123456789012345
Console.WriteLine(myInt.ToString("N", nfi))
' Displays the same value with different groupings.
Dim mySizes1 As Integer() = {2, 3, 4}
Dim mySizes2 As Integer() = {2, 3, 0}
nfi.NumberGroupSizes = mySizes1
Console.WriteLine(myInt.ToString("N", nfi))
nfi.NumberGroupSizes = mySizes2
Console.WriteLine(myInt.ToString("N", nfi))
End Sub 'Main
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#]
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( "N", nfi ) );
// Displays the same value with different groupings.
int[] mySizes1 = {2,3,4};
int[] mySizes2 = {2,3,0};
nfi.NumberGroupSizes = mySizes1;
Console.WriteLine( myInt.ToString( "N", nfi ) );
nfi.NumberGroupSizes = mySizes2;
Console.WriteLine( myInt.ToString( "N", nfi ) );
}
}
/*
This code produces the following output.
123,456,789,012,345.00
12,3456,7890,123,45.00
1234567890,123,45.00
*/
[C++]
#using <mscorlib.dll>
using namespace System;
using namespace System::Globalization;
int main()
{
// Gets a NumberFormatInfo associated with the en-US culture.
CultureInfo * MyCI = new CultureInfo(S"en-US", false);
NumberFormatInfo* nfi = MyCI -> NumberFormat;
// Displays a value with the default separator (S".").
Int64 myInt = 123456789012345;
Console::WriteLine(myInt.ToString(S"N", nfi));
// Displays the same value with different groupings.
Int32 mySizes1[] = {2, 3, 4};
Int32 mySizes2[] = {2, 3, 0};
nfi -> NumberGroupSizes = mySizes1;
Console::WriteLine(myInt.ToString(S"N", nfi));
nfi -> NumberGroupSizes = mySizes2;
Console::WriteLine(myInt.ToString(S"N", nfi));
}
/*
This code produces the following output.
123, 456, 789, 012, 345.00
12, 3456, 7890, 123, 45.00
1234567890, 123, 45.00
*/
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard
参照
NumberFormatInfo クラス | NumberFormatInfo メンバ | System.Globalization 名前空間 | NumberDecimalDigits | NumberDecimalSeparator | NumberGroupSeparator | NaNSymbol | NumberNegativePattern | CurrencyGroupSizes | PercentGroupSizes