NumberFormatInfo.CurrencyGroupSizes Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die Anzahl von Ziffern in jeder Gruppe links vom Dezimaltrennzeichen in Währungsangaben ab oder legt diese fest.
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, setPublic Property CurrencyGroupSizes As Integer()Eigenschaftswert
Die Anzahl von Ziffern in jeder Gruppe links vom Dezimaltrennzeichen in Währungsangaben. Der Standard für InvariantInfo ist ein eindimensionales Array, das ein einziges, auf 3 festgelegtes Element enthält.
Ausnahmen
Die Eigenschaft wird auf null festgelegt.
Die Eigenschaft wird festgelegt, und das Array enthält einen Eintrag, der kleiner als 0 oder größer als 9 ist.
- oder -
Die Eigenschaft wird festgelegt, und das Array enthält einen Eintrag, der nicht der letzte Eintrag ist, der auf 0 festgelegt ist.
Die Eigenschaft wird festgelegt, und das NumberFormatInfo-Objekt ist schreibgeschützt.
Beispiele
Im folgenden Beispiel wird die Auswirkung der Änderung der CurrencyGroupSizes Eigenschaft veranschaulicht.
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".").
Int64 myInt = 123456789012345;
Console::WriteLine( myInt.ToString( "C", nfi ) );
// Displays the same value with different groupings.
array<Int32>^mySizes1 = {2,3,4};
array<Int32>^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
*/
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
Hinweise
Die CurrencyGroupSizes -Eigenschaft wird mit der Standardformatzeichenfolge "C" verwendet, um die Anzahl der Ziffern zu definieren, die in integralen Gruppen angezeigt werden. Weitere Informationen finden Sie unter Numerische Standard-Formatzeichenfolgen. Jedes Element im eindimensionalen Array muss eine ganze Zahl von 1 bis 9 sein. Das letzte Element kann 0 sein.
Das erste Element des Arrays definiert die Anzahl der Elemente in der am wenigsten signifikanten Gruppe von Ziffern unmittelbar links von CurrencyDecimalSeparator. Jedes nachfolgende Element verweist auf die nächste signifikante Gruppe von Ziffern links von der vorherigen Gruppe. Wenn das letzte Element des Arrays nicht 0 ist, werden die verbleibenden Ziffern basierend auf dem letzten Element des Arrays gruppiert. Wenn das letzte Element 0 ist, werden die verbleibenden Ziffern nicht gruppiert.
Wenn das Array beispielsweise { 3, 4, 5 } enthält, werden die Ziffern ähnlich wie "$55,55555,55555,55555,4444,333.00" gruppiert. Wenn das Array { 3, 4, 0 } enthält, werden die Ziffern ähnlich wie "$55555555555555555,4444,333.00" gruppiert.
