NumberFormatInfo.PercentGroupSizes Propriedade

  • Referência

Definição

Namespace:
System.Globalization
Assembly:
System.Globalization.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Origem:
NumberFormatInfo.cs
Origem:
NumberFormatInfo.cs
Origem:
NumberFormatInfo.cs

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, 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. O padrão para InvariantInfo é uma matriz unidimensional com apenas um elemento, que é definido como 3.

Exceções

ArgumentNullException

A propriedade está sendo definida como null.

ArgumentException

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.

InvalidOperationException

A propriedade está sendo definida e o objeto NumberFormatInfo é somente leitura.

Exemplos

O exemplo a seguir demonstra o efeito da alteração da PercentGroupSizes 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".").
   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. 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 PercentDecimalSeparator. 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 semelhantes a "55.55555.5555,55555,4444.333,00%". Se a matriz contiver { 3, 4, 0 }, os dígitos serão agrupados de forma semelhante a "555555555555555,4444,333,00%".

Aplica-se a

Confira também