NumberFormatInfo.CurrencyGroupSizes Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau mengatur jumlah digit di setiap grup di sebelah kiri desimal dalam nilai mata uang.
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()
Nilai Properti
Jumlah digit di setiap grup di sebelah kiri desimal dalam nilai mata uang. Default untuk InvariantInfo adalah array satu dimensi dengan hanya satu elemen, yang diatur ke 3.
Pengecualian
Properti sedang diatur ke null
.
Properti sedang diatur dan array berisi entri yang kurang dari 0 atau lebih besar dari 9.
-atau-
Properti sedang diatur dan array berisi entri, selain entri terakhir, yang diatur ke 0.
Properti sedang diatur dan NumberFormatInfo objek bersifat baca-saja.
Contoh
Contoh berikut menunjukkan efek mengubah CurrencyGroupSizes properti.
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
Keterangan
Properti CurrencyGroupSizes digunakan dengan string format standar "C" untuk menentukan jumlah digit yang muncul dalam grup integral. Untuk informasi selengkapnya, lihat String Format Numerik Standar. Setiap elemen dalam array satu dimensi harus berupa bilangan bulat dari 1 hingga 9. Elemen terakhir bisa 0.
Elemen pertama dari array mendefinisikan jumlah elemen dalam grup digit yang paling tidak signifikan segera di sebelah kiri CurrencyDecimalSeparator. Setiap elemen berikutnya mengacu pada grup digit signifikan berikutnya di sebelah kiri grup sebelumnya. Jika elemen terakhir dari array bukan 0, digit yang tersisa dikelompokkan berdasarkan elemen terakhir dari array. Jika elemen terakhir adalah 0, digit yang tersisa tidak dikelompokkan.
Misalnya, jika array berisi { 3, 4, 5 }, digit dikelompokkan mirip dengan "$55,55555,55555,55555,4444,333.00". Jika array berisi { 3, 4, 0 }, digit dikelompokkan mirip dengan "$555555555555555,4444,333,00".