NumberFormatInfo.PercentGroupSizes 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 in procentwaarden.
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()Waarde van eigenschap
Het aantal cijfers in elke groep links van de decimale in procentwaarden. 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 PercentGroupSizes 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 (".").
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 %
Opmerkingen
De PercentGroupSizes eigenschap wordt gebruikt met de standaardtekenreeks voor de standaardnotatie P 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 PercentDecimalSeparatormatrix. 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 zoals '55.55555.55555.55555.55555.4444.333.00%'. Als de matrix { 3, 4, 0 } bevat, worden de cijfers gegroepeerd zoals "55555555555555555555555,4444.333.00%".
