NumberFormatInfo.CurrencyGroupSizes Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt het aantal cijfers in elke groep opgehaald of ingesteld links van de decimale waarden in valutawaarden.
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()
Waarde van eigenschap
Het aantal cijfers in elke groep links van de decimale waarden in valutawaarden. De standaardwaarde InvariantInfo is een eendimensionale matrix met slechts één element, dat is ingesteld op 3.
Uitzonderingen
De eigenschap wordt ingesteld op null.
De eigenschap wordt ingesteld en de matrix bevat een vermelding die kleiner is dan 0 of groter dan 9.
– of –
De eigenschap wordt ingesteld en de matrix bevat een vermelding, behalve de laatste vermelding, die is ingesteld op 0.
De eigenschap wordt ingesteld en het object heeft het NumberFormatInfo kenmerk Alleen-lezen.
Voorbeelden
In het volgende voorbeeld ziet u het effect van het wijzigen van de CurrencyGroupSizes eigenschap.
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
Opmerkingen
De CurrencyGroupSizes eigenschap wordt gebruikt met de tekenreeks voor de standaardnotatie C om het aantal cijfers te definiëren dat in integrale groepen wordt weergegeven. Zie Standaardtekenreeksen voor numerieke notatie voor meer informatie. Elk element in de eendimensionale matrix moet een geheel getal van 1 tot en met 9 zijn. Het laatste element kan 0 zijn.
Het eerste element van de matrix definieert het aantal elementen in de minst significante groep cijfers direct links van de CurrencyDecimalSeparatormatrix. Elk volgend element verwijst naar de volgende significante groep cijfers links van de vorige groep. Als het laatste element van de matrix niet 0 is, worden de resterende cijfers gegroepeerd op basis van het laatste element van de matrix. Als het laatste element 0 is, worden de resterende cijfers niet gegroepeerd.
Als de matrix bijvoorbeeld { 3, 4, 5 } bevat, worden de cijfers gegroepeerd op '\$55.55555.55555.55555.55555.4444.333.00'. Als de matrix { 3, 4, 0 } bevat, worden de cijfers gegroepeerd op "\$55555555555555555555555555,4444.333,00".