NumberFormatInfo.PercentGroupSizes Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define o número de dígitos em cada grupo à esquerda do decimal em valores percentuais.
public:
property cli::array <int> ^ PercentGroupSizes { cli::array <int> ^ get(); void set(cli::array <int> ^ value); };public int[] PercentGroupSizes { get; set; }member this.PercentGroupSizes : int[] with get, setPublic Property PercentGroupSizes As Integer()Valor de Propriedade
O número de dígitos em cada grupo à esquerda do decimal em valores percentuais. O padrão para InvariantInfo é um array unidimensional com apenas um elemento, que está definido para 3.
Exceções
A propriedade está a ser definida para null.
A propriedade está a ser definida e o array contém uma entrada menor que 0 ou superior a 9.
-ou-
A propriedade está a ser definida e o array contém uma entrada, diferente da última entrada, que está definida como 0.
A propriedade está a ser definida e o NumberFormatInfo objeto é apenas de leitura.
Exemplos
O exemplo seguinte demonstra o efeito de alterar a PercentGroupSizes 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 (".").
Double myInt = 123456789012345.6789;
Console.WriteLine( myInt.ToString( "P", nfi ) );
// Displays the same value with different groupings.
int[] mySizes1 = {2,3,4};
int[] mySizes2 = {2,3,0};
nfi.PercentGroupSizes = mySizes1;
Console.WriteLine( myInt.ToString( "P", nfi ) );
nfi.PercentGroupSizes = mySizes2;
Console.WriteLine( myInt.ToString( "P", nfi ) );
}
}
/*
This code produces the following output.
12,345,678,901,234,600.00 %
1234,5678,9012,346,00.00 %
123456789012,346,00.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 [Double] = 123456789012345.6789
Console.WriteLine(myInt.ToString("P", nfi))
' Displays the same value with different groupings.
Dim mySizes1 As Integer() = {2, 3, 4}
Dim mySizes2 As Integer() = {2, 3, 0}
nfi.PercentGroupSizes = mySizes1
Console.WriteLine(myInt.ToString("P", nfi))
nfi.PercentGroupSizes = mySizes2
Console.WriteLine(myInt.ToString("P", nfi))
End Sub
End Class
'This code produces the following output.
'
'12,345,678,901,234,600.00 %
'1234,5678,9012,346,00.00 %
'123456789012,346,00.00 %
Observações
A PercentGroupSizes propriedade é usada com a cadeia de formato padrão "P" para definir o número de dígitos que aparecem em grupos inteiros. 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 PercentDecimalSeparator. 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,55555,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%".
