NumberFormatInfo.PercentGroupSizes Propriété

  • Référence

Définition

Espace de noms:
System.Globalization
Assembly:
System.Globalization.dll
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll
Assembly:
mscorlib.dll

Obtient ou définit le nombre de chiffres dans chaque groupe à gauche du séparateur décimal dans les valeurs de pourcentage.

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

Valeur de propriété

Int32[]

Nombre de chiffres dans chaque groupe à gauche du séparateur décimal dans les valeurs de pourcentage. Par défaut, InvariantInfo est un tableau unidimensionnel avec un seul élément ayant pour valeur 3.

Exceptions

ArgumentNullException

La propriété est définie sur null.

ArgumentException

La propriété est définie, et le tableau contient une entrée inférieure à 0 ou supérieure à 9.

  • ou -

La propriété est définie, et le tableau contient une entrée, autre que la dernière entrée, qui est définie sur 0.

InvalidOperationException

La propriété est définie et l’objet NumberFormatInfo est en lecture seule.

Exemples

L’exemple suivant illustre l’effet de la modification de la PercentGroupSizes propriété.

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 %

Remarques

La PercentGroupSizes propriété est utilisée avec la chaîne de format standard "P" pour définir le nombre de chiffres qui s’affichent dans les groupes intégraux. Pour plus d’informations, consultez Chaînes de format numériques standard. Chaque élément du tableau unidimensionnel doit être un entier compris entre 1 et 9. Le dernier élément peut avoir la valeur 0.

Le premier élément du tableau définit le nombre d’éléments dans le groupe de chiffres le moins significatif immédiatement à gauche de PercentDecimalSeparator . Chaque élément suivant fait référence au groupe de chiffres significatif suivant à gauche du groupe précédent. Si le dernier élément du tableau n’est pas 0, les chiffres restants sont regroupés en fonction du dernier élément du tableau. Si le dernier élément a la valeur 0, les chiffres restants ne sont pas regroupés.

Par exemple, si le tableau contient {3, 4, 5}, les chiffres sont regroupés comme « 55, 55555, 55555, 55555, 4444, 333.00% ». Si le tableau contient {3, 4, 0}, les chiffres sont regroupés comme « 55555555555555555, 4444, 333.00% ».

S’applique à

Voir aussi