NumberFormatInfo.PercentGroupSizes Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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, setPublic Property PercentGroupSizes As Integer()Valeur de propriété
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
La propriété est définie sur null.
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.
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 apparaissent 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 être 0.
Le premier élément du tableau définit le nombre d’éléments dans le groupe le moins significatif de chiffres immédiatement à gauche de PercentDecimalSeparator. Chaque élément suivant fait référence au groupe significatif suivant de chiffres à 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 est 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 5555555555555555555555 4444 333,00 % ». Si le tableau contient { 3, 4, 0 }, les chiffres sont regroupés comme « 55555555555555555555555555555,4444 333,00 % ».
