NumberFormatInfo.CurrencyGroupSizes 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定貨幣值內小數點左邊數字的各個群組中的位數。
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[]
貨幣值內小數點左邊數字的各個群組中的位數。 InvariantInfo 的預設值為一個只含有一個項目 (已設定為 3) 的一維陣列。
例外狀況
正在將屬性設定為 null
。
正在設定屬性,而且 NumberFormatInfo 物件為唯讀。
範例
下列範例示範變更 CurrencyGroupSizes 屬性的效果。
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
'This code produces the following output.
'
'$123,456,789,012,345.00
'$12,3456,7890,123,45.00
'$1234567890,123,45.00
備註
屬性 CurrencyGroupSizes 會與 「C」 標準格式字串搭配使用,以定義出現在整數群組中的位數。 如需詳細資訊,請參閱標準數值格式字串。 一維陣列中的每個元素都必須是 1 到 9 的整數。 最後一個專案可以是 0。
陣列的第一個元素會定義最不重要數位群組中緊接在 左邊 CurrencyDecimalSeparator的項目數目。 每個後續元素都會參考上一個群組左邊的下一個顯著數位群組。 如果陣列的最後一個專案不是 0,剩餘的數位會根據數位的最後一個元素進行分組。 如果最後一個專案是 0,則剩餘的數位不會分組。
例如,如果數位包含 {3, 4, 5 },則數位會分組為類似 “$55,555555,55555,4444,333.00”。 如果陣列包含 { 3, 4, 0 },則數位會分組為類似 “$555555555555555555,4444,333.00”。