NumberFormatInfo.CurrencyGroupSizes Properti

Definisi

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

Int32[]

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

Berlaku untuk

Lihat juga