NumberFormatInfo.PercentGroupSizes Propriedade

Definição

Obtém ou define o número de dígitos em cada grupo à esquerda do decimal em valores percentuais.Gets or sets the number of digits in each group to the left of the decimal in percent values.

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, set
Public Property PercentGroupSizes As Integer()

Valor da propriedade

Int32[]

O número de dígitos em cada grupo à esquerda do decimal em valores percentuais.The number of digits in each group to the left of the decimal in percent values. O padrão para InvariantInfo é uma matriz unidimensional com apenas um elemento, que é definido como 3.The default for InvariantInfo is a one-dimensional array with only one element, which is set to 3.

Exceções

A propriedade está sendo definida como null.The property is being set to null.

A propriedade está sendo definida e a matriz contém uma entrada que é menor que 0 ou maior que 9.The property is being set and the array contains an entry that is less than 0 or greater than 9.

- ou --or-

A propriedade está sendo definida e a matriz contém uma entrada, sem ser a última entrada, que está definida como 0.The property is being set and the array contains an entry, other than the last entry, that is set to 0.

A propriedade está sendo definida e o objeto NumberFormatInfo é somente leitura.The property is being set and the NumberFormatInfo object is read-only.

Exemplos

O exemplo a seguir demonstra o efeito da alteração PercentGroupSizes da propriedade.The following example demonstrates the effect of changing the PercentGroupSizes property.

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".").
   Double myInt = 123456789012345.6789;
   Console::WriteLine( myInt.ToString( "P", nfi ) );
   
   // Displays the same value with different groupings.
   array<Int32>^mySizes1 = {2,3,4};
   array<Int32>^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 %
*/
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 %


Comentários

A PercentGroupSizes propriedade é usada com a cadeia de caracteres de formato padrão "P" para definir o número de dígitos que aparecem em grupos integrais.The PercentGroupSizes property is used with the "P" standard format string to define the number of digits that appear in integral groups. Para obter mais informações, confira Cadeias de caracteres de formato numérico padrão.For more information, see Standard Numeric Format Strings. Cada elemento na matriz unidimensional deve ser um inteiro de 1 a 9.Every element in the one-dimensional array must be an integer from 1 through 9. O último elemento pode ser 0.The last element can be 0.

O primeiro elemento da matriz define o número de elementos no grupo menos significativo de dígitos imediatamente à esquerda do PercentDecimalSeparator.The first element of the array defines the number of elements in the least significant group of digits immediately to the left of the PercentDecimalSeparator. Cada elemento subsequente refere-se ao próximo grupo significativo de dígitos à esquerda do grupo anterior.Each subsequent element refers to the next significant group of digits to the left of the previous group. Se o último elemento da matriz não for 0, os dígitos restantes serão agrupados com base no último elemento da matriz.If the last element of the array is not 0, the remaining digits are grouped based on the last element of the array. Se o último elemento for 0, os dígitos restantes não serão agrupados.If the last element is 0, the remaining digits are not grouped.

Por exemplo, se a matriz contiver {3, 4, 5}, os dígitos serão agrupados de forma semelhante a "55, 55555, 55555, 55555, 4444, 333.00%".For example, if the array contains { 3, 4, 5 }, the digits are grouped similar to "55,55555,55555,55555,4444,333.00%". Se a matriz contiver {3, 4, 0}, os dígitos serão agrupados de forma semelhante a "55555555555555555, 4444, 333.00%".If the array contains { 3, 4, 0 }, the digits are grouped similar to "55555555555555555,4444,333.00%".

Aplica-se a

Veja também