NumberFormatInfo.NumberGroupSizes プロパティとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

NumberFormatInfo.NumberGroupSizes プロパティ

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

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

Visual Basic (宣言)

Public Property NumberGroupSizes As
 Integer()

Visual Basic (使用法)

Dim instance As NumberFormatInfo
Dim value As Integer()

value = instance.NumberGroupSizes

instance.NumberGroupSizes = value

public int[] NumberGroupSizes { get;
 set; }

C++

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

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

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

JScript

public function get NumberGroupSizes
 () : int[]

public function set NumberGroupSizes
 (value : int[])

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

例外

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

例外の種類

条件

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" のようにグループ化されます。

使用例

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

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

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 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( "N", nfi ) );
   
   // Displays the same value with different groupings.
   array<Int32>^mySizes1 = {2,3,4};
   array<Int32>^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
*/

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 (".").
        Int64 myInt = (Int64)(123456789012345L);
        Console.WriteLine(myInt.ToString("N", nfi));
        // Displays the same value with different groupings.
        int mySizes1[] =  { 2, 3, 4 };
        int mySizes2[] =  { 2, 3, 0 };
        nfi.set_NumberGroupSizes(mySizes1);
        Console.WriteLine(myInt.ToString("N", nfi));
        nfi.set_NumberGroupSizes(mySizes2);
        Console.WriteLine(myInt.ToString("N", nfi));
    } //main 
} //NumberFormatInfoSample

/* 
This code produces the following output.

123,456,789,012,345.00
12,3456,7890,123,45.00
1234567890,123,45.00
*/

さまざまな NumberGroupSizes 配列を使用して値を出力するコード例を次に示します。

Visual Basic

Imports System
Imports System.Globalization
Imports Microsoft.VisualBasic

Class SamplesNumberFormatInfo
    
    Public Shared Sub Main()
        
        ' Creates a new NumberFormatinfo.
        Dim myNfi As New
 NumberFormatInfo()
        
        ' Takes a long value.
        Dim myInt As Int64 = 123456789012345
        
        ' Displays the value with default formatting.
        Console.WriteLine("Default  " + ControlChars.Tab
 + ControlChars.Tab _
           + ":" + ControlChars.Tab + "{0}",
 myInt.ToString("N", myNfi))
        
        ' Displays the value with three elements in the GroupSize array.
        myNfi.NumberGroupSizes = New Integer()
 {2, 3, 4}
        Console.WriteLine("Grouping ( {0} )" + ControlChars.Tab
 + ":" _
           + ControlChars.Tab + "{1}", _
           PrintArraySet(myNfi.NumberGroupSizes), myInt.ToString("N",
 myNfi))
        
        ' Displays the value with zero as the last element in the GroupSize
 array.
        myNfi.NumberGroupSizes = New Integer()
 {2, 4, 0}
        Console.WriteLine("Grouping ( {0} )" + ControlChars.Tab
 + ":" _
           + ControlChars.Tab + "{1}", _
           PrintArraySet(myNfi.NumberGroupSizes), myInt.ToString("N",
 myNfi))
    End Sub
    
    
    Public Shared Function
 PrintArraySet(myArr() As Integer) As
 String
        Dim myStr As String
 = Nothing
        myStr = myArr(0).ToString()
        Dim i As Integer
        For i = 1 To myArr.Length - 1
            myStr += ", " + myArr(i).ToString()
        Next i
        Return myStr
    End Function
End Class

' This code produces the following output. 
' 
' Default                 :       123,456,789,012,345.00
' Grouping ( 2, 3, 4 )    :       12,3456,7890,123,45.00
' Grouping ( 2, 4, 0 )    :       123456789,0123,45.00

using System;
using System.Globalization;
class SamplesNumberFormatInfo  {

   public static void Main()
  {

      // Creates a new NumberFormatinfo.
      NumberFormatInfo myNfi = new NumberFormatInfo();

      // Takes a long value.
      Int64 myInt = 123456789012345;

      // Displays the value with default formatting.
      Console.WriteLine( "Default  \t\t:\t{0}", myInt.ToString( "N",
 myNfi ) );

      // Displays the value with three elements in the GroupSize array.
      myNfi.NumberGroupSizes = new int[]  {
 2, 3, 4 };
      Console.WriteLine( "Grouping ( {0} )\t:\t{1}",
         PrintArraySet( myNfi.NumberGroupSizes ), myInt.ToString( "N",
 myNfi ) );

      // Displays the value with zero as the last element in the GroupSize
 array.
      myNfi.NumberGroupSizes = new int[]  {
 2, 4, 0 };
      Console.WriteLine( "Grouping ( {0} )\t:\t{1}",
         PrintArraySet( myNfi.NumberGroupSizes ), myInt.ToString( "N",
 myNfi ) );
   }

   public static string
 PrintArraySet( int[] myArr )  {
      string myStr = null;
      myStr = myArr[0].ToString();
      for ( int i = 1; i < myArr.Length;
 i++ )
         myStr += ", " + myArr[i].ToString();
      return( myStr );
   }
}
/*
This code produces the following output. 

Default                 :       123,456,789,012,345.00
Grouping ( 2, 3, 4 )    :       12,3456,7890,123,45.00
Grouping ( 2, 4, 0 )    :       123456789,0123,45.00
*/

C++

using namespace System;
using namespace System::Globalization;
String^ PrintArraySet( array<Int32>^myArr )
{
   String^ myStr = nullptr;
   myStr = myArr[ 0 ].ToString();
   for ( int i = 1; i < myArr->Length;
 i++ )
      myStr = String::Concat( myStr, ", ", myArr[ i ].ToString() );
   return myStr;
}

int main()
{
   
   // Creates a new NumberFormatinfo.
   NumberFormatInfo^ myNfi = gcnew NumberFormatInfo;
   
   // Takes a long value.
   Int64 myInt = 123456789012345;
   
   // Displays the value with default formatting.
   Console::WriteLine( "Default  \t\t:\t{0}", myInt.ToString( "N",
 myNfi ) );
   
   // Displays the value with three elements in the GroupSize array.
   array<Int32>^newInts1 = {2,3,4};
   myNfi->NumberGroupSizes = newInts1;
   Console::WriteLine( "Grouping ( {0} )\t:\t{1}", PrintArraySet( myNfi->NumberGroupSizes
 ), myInt.ToString( "N", myNfi ) );
   
   // Displays the value with zero as the last element in the GroupSize
 array.
   array<Int32>^newInts2 = {2,4,0};
   myNfi->NumberGroupSizes = newInts2;
   Console::WriteLine( "Grouping ( {0} )\t:\t{1}", PrintArraySet( myNfi->NumberGroupSizes
 ), myInt.ToString( "N", myNfi ) );
}

/*
This code produces the following output. 

Default               :       123, 456, 789, 012, 345.00
Grouping (2, 3, 4)    :       12, 3456, 7890, 123, 45.00
Grouping (2, 4, 0)    :       123456789, 0123, 45.00
*/

JScript

import System
import System.Globalization
import System.Text

// Creates a new NumberFormatinfo.
var myNfi : NumberFormatInfo = new NumberFormatInfo()

// Takes a long value.
var myInt : long = 123456789012345

// Displays the value with default formatting.
Console.WriteLine("Default  \t\t:\t{0}", myInt.ToString("N",
 myNfi))

// Displays the value with three elements in the GroupSize array.
myNfi.NumberGroupSizes = [2, 3, 4]
Console.WriteLine("Grouping ( {0} )\t:\t{1}", PrintArraySet(myNfi.NumberGroupSizes),
 myInt.ToString("N", myNfi))

// Displays the value with zero : the last element in the GroupSize
 array.
myNfi.NumberGroupSizes = [2, 4, 0]
Console.WriteLine("Grouping ( {0} )\t:\t{1}", PrintArraySet(myNfi.NumberGroupSizes),
 myInt.ToString("N", myNfi))


function PrintArraySet(myArr : int[]) : String{
  var myStr : StringBuilder = new StringBuilder()
  myStr.Append(myArr[0].ToString())
  for(var i = 1; i < myArr.Length; i++){
      myStr.Append(", " + myArr[i].ToString())
  }
  return myStr.ToString()
}

// This code produces the following output. 
// 
// Default                 :       123,456,789,012,345.00
// Grouping ( 2, 3, 4 )    :       12,3456,7890,123,45.00
// Grouping ( 2, 4, 0 )    :       123456789,0123,45.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.NumberDecimalDigits プロパティ
NumberFormatInfo.NumberDecimalSeparator プロパティ
NumberFormatInfo.NumberGroupSeparator プロパティ
NumberFormatInfo.NaNSymbol プロパティ
NumberNegativePattern
NumberFormatInfo.CurrencyGroupSizes プロパティ
PercentGroupSizes

>> 「NumberFormatInfo.NumberGroupSizes プロパティ」を含む用語の索引
NumberFormatInfo.NumberGroupSizes プロパティのページへのリンク

NumberFormatInfo.NumberGroupSizes プロパティとは？わかりやすく解説

NumberFormatInfo.NumberGroupSizes プロパティ

「NumberFormatInfo.NumberGroupSizes プロパティ」の関連用語


	© 2025 Microsoft.All rights reserved.

NumberFormatInfo.NumberGroupSizes プロパティとは？ わかりやすく解説

NumberFormatInfo.NumberGroupSizes プロパティ

急上昇のことば

「NumberFormatInfo.NumberGroupSizes プロパティ」の関連用語

NumberFormatInfo.NumberGroupSizes プロパティとは？わかりやすく解説