NumberFormatInfo.CurrencyGroupSizes Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define o número de dígitos em cada grupo à esquerda do decimal em valores de moeda.
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, setPublic Property CurrencyGroupSizes As Integer()Valor da propriedade
O número de dígitos em cada grupo à esquerda do decimal em valores de moeda. O padrão para InvariantInfo é uma matriz unidimensional com apenas um elemento, que é definido como 3.
Exceções
A propriedade está sendo definida como null.
A propriedade está sendo definida e a matriz contém uma entrada que é menor que 0 ou maior que 9.
- ou -
A propriedade está sendo definida e a matriz contém uma entrada, sem ser a última entrada, que está definida como 0.
A propriedade está sendo definida e o objeto NumberFormatInfo é somente leitura.
Exemplos
O exemplo a seguir demonstra o efeito da alteração da CurrencyGroupSizes propriedade .
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
Comentários
A CurrencyGroupSizes propriedade é usada com a cadeia de caracteres de formato padrão "C" para definir o número de dígitos que aparecem em grupos integrais. Para obter mais informações, confira Cadeias de caracteres de formato numérico padrão. Cada elemento na matriz unidimensional deve ser um inteiro de 1 a 9. O último elemento pode ser 0.
O primeiro elemento da matriz 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 da matriz não for 0, os dígitos restantes serão agrupados com base no último elemento da matriz. Se o último elemento for 0, os dígitos restantes não serão agrupados.
Por exemplo, se a matriz contiver { 3, 4, 5 }, os dígitos serão agrupados de forma semelhante a "$55.55555.5555.5555.4444.333,00". Se a matriz contiver { 3, 4, 0 }, os dígitos serão agrupados de forma semelhante a "$55555555555555555,4444,333,00".
