NumberFormatInfo.CurrencyGroupSizes 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 de chaque groupe à gauche de la décimale dans les valeurs monétaires.
public:
property cli::array <int> ^ CurrencyGroupSizes { cli::array <int> ^ get(); void set(cli::array <int> ^ value); };
public int[] CurrencyGroupSizes { get; set; }
member this.CurrencyGroupSizes : int[] with get, set
Public Property CurrencyGroupSizes As Integer()
Valeur de propriété
Nombre de chiffres dans chaque groupe à gauche de la décimale dans les valeurs monétaires. La valeur par défaut InvariantInfo est un tableau unidimensionnel avec un seul élément, qui est défini sur 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 CurrencyGroupSizes propriété.
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 (".").
Int64 myInt = 123456789012345;
Console.WriteLine( myInt.ToString( "C", nfi ) );
// Displays the same value with different groupings.
int[] mySizes1 = {2,3,4};
int[] mySizes2 = {2,3,0};
nfi.CurrencyGroupSizes = mySizes1;
Console.WriteLine( myInt.ToString( "C", nfi ) );
nfi.CurrencyGroupSizes = mySizes2;
Console.WriteLine( myInt.ToString( "C", nfi ) );
}
}
/*
This code produces the following output.
$123,456,789,012,345.00
$12,3456,7890,123,45.00
$1234567890,123,45.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 Int64 = 123456789012345
Console.WriteLine(myInt.ToString("C", nfi))
' Displays the same value with different groupings.
Dim mySizes1 As Integer() = {2, 3, 4}
Dim mySizes2 As Integer() = {2, 3, 0}
nfi.CurrencyGroupSizes = mySizes1
Console.WriteLine(myInt.ToString("C", nfi))
nfi.CurrencyGroupSizes = mySizes2
Console.WriteLine(myInt.ToString("C", nfi))
End Sub
End Class
'This code produces the following output.
'
'$123,456,789,012,345.00
'$12,3456,7890,123,45.00
'$1234567890,123,45.00
Remarques
La CurrencyGroupSizes propriété est utilisée avec la chaîne de format standard « C » pour définir le nombre de chiffres qui apparaissent dans les groupes intégraux. Pour plus d’informations, consultez Chaînes de format numérique 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 du CurrencyDecimalSeparator. 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,55555,55555,555555,4444,333.00 ». Si le tableau contient { 3, 4, 0 }, les chiffres sont regroupés comme « \$55555555555555555555555555,4444,333.00 ».