NumberFormatInfo.CurrencyGroupSizes Propriedade

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

Valor de Propriedade

O número de dígitos em cada grupo à esquerda do decimal nos valores da moeda. O padrão para InvariantInfo é um array unidimensional com apenas um elemento, que está definido para 3.

Exceções

Exemplos

O exemplo seguinte demonstra o efeito de alterar a CurrencyGroupSizes propriedade.

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

Observações

A CurrencyGroupSizes propriedade é usada com a cadeia de formato padrão "C" para definir o número de dígitos que aparecem nos grupos integrais. Para mais informações, consulte Strings de Formato Numérico Padrão. Cada elemento no array unidimensional deve ser um inteiro de 1 a 9. O último elemento pode ser 0.

O primeiro elemento do array define o número de elementos no grupo de dígitos menos significativo imediatamente à esquerda do CurrencyDecimalSeparator. Cada elemento subsequente refere-se ao próximo grupo significativo de dígitos à esquerda do grupo anterior. Se o último elemento do array não for 0, os dígitos restantes são agrupados com base no último elemento do array. Se o último elemento for 0, os dígitos restantes não são agrupados.

Por exemplo, se o array contiver { 3, 4, 5 }, os dígitos estão agrupados de forma semelhante a "\$55,55555,5555,5555,4444,333,00". Se o array contiver { 3, 4, 0 }, os dígitos são agrupados de forma semelhante a "\$5555555555555,4444,333,00".

Ver também

• CurrencyDecimalDigits
• CurrencyDecimalSeparator
• CurrencyGroupSeparator
• CurrencySymbol
• CurrencyNegativePattern
• CurrencyPositivePattern
• NumberGroupSizes
• PercentGroupSizes