NumberFormatInfo.PercentGroupSizes 屬性

定義

命名空間:

System.Globalization

組件:

System.Runtime.dll

來源:

NumberFormatInfo.cs

取得或設定百分比值內小數點左邊數字的各個群組中的位數。

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

public int[] PercentGroupSizes { get; set; }

member this.PercentGroupSizes : int[] with get, set

Public Property PercentGroupSizes As Integer()

屬性值

Int32[]

百分比值內小數點左邊數字的各個群組中的位數。 InvariantInfo 的預設值為一個只含有一個項目 (已設定為 3) 的一維陣列。

例外狀況

ArgumentNullException

正在將屬性設定為 null。

ArgumentException

將設定此屬性，且此陣列包含小於 0 或大於 9 的項目。

-或-

將設定此屬性，且此陣列除了最後一個項目之外包含一個項目，此項目會設定為 0。

InvalidOperationException

正在設定屬性，而且 NumberFormatInfo 物件為唯讀。

範例

下列範例示範變更 PercentGroupSizes 屬性的效果。

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 %
*/

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 %
*/

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

End Class


'This code produces the following output.
'
'12,345,678,901,234,600.00 %
'1234,5678,9012,346,00.00 %
'123456789012,346,00.00 %

備註

屬性 PercentGroupSizes 會與 「P」 標準格式字串搭配使用，以定義出現在整數群組中的位數。 如需詳細資訊，請參閱標準數值格式字串。 一維陣列中的每個元素都必須是介於1到9的整數。 最後一個專案可以是 0。

陣列的第一個項目會定義緊接在 左邊 PercentDecimalSeparator最小有效位數群組中的元素數目。 每個後續元素都會參考前一個群組左邊的下一個重要數位群組。 如果陣列的最後一個專案不是 0，剩餘的數位會根據數位的最後一個項目進行分組。 如果最後一個專案是 0，則剩餘的數位不會分組。

例如，如果數位包含 {3， 4， 5 }，數位會分組為類似 “55,555555,55555,555555,4444,333.00%”。 如果陣列包含 { 3， 4， 0 }，數位會分組為類似 “55555555555555555555,4444,333.00%”。

另請參閱

• PercentDecimalDigits
• PercentDecimalSeparator
• PercentGroupSeparator
• PercentSymbol
• PercentNegativePattern
• PercentPositivePattern
• CurrencyGroupSizes
• NumberGroupSizes