Freigeben über


NumberFormatInfo.CurrencyGroupSizes-Eigenschaft

Ruft die Anzahl von Ziffern in jeder Gruppe links vom Dezimaltrennzeichen in Währungsangaben ab oder legt diese fest.

Namespace: System.Globalization
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Property CurrencyGroupSizes As Integer()
'Usage
Dim instance As NumberFormatInfo
Dim value As Integer()

value = instance.CurrencyGroupSizes

instance.CurrencyGroupSizes = value
public int[] CurrencyGroupSizes { get; set; }
public:
property array<int>^ CurrencyGroupSizes {
    array<int>^ get ();
    void set (array<int>^ value);
}
/** @property */
public int[] get_CurrencyGroupSizes ()

/** @property */
public void set_CurrencyGroupSizes (int[] value)
public function get CurrencyGroupSizes () : int[]

public function set CurrencyGroupSizes (value : int[])

Eigenschaftenwert

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

Ausnahmetyp Bedingung

ArgumentNullException

Die Eigenschaft wird auf NULL (Nothing in Visual Basic) festgelegt.

ArgumentException

Die Eigenschaft wird festgelegt, und das Array enthält einen Eintrag, dessen Wert kleiner als 0 (null) oder größer als 9 ist.

– oder –

Die Eigenschaft wird festgelegt, und das Array enthält einen Eintrag, der nicht der letzte Eintrag und auf 0 (null) festgelegt ist.

InvalidOperationException

Die Eigenschaft wird festgelegt, und NumberFormatInfo ist schreibgeschützt.

Hinweise

Jedes Element im eindimensionalen Array muss eine Ganzzahl von 1 bis 9 sein. Das letzte Element kann 0 (null) sein.

Das erste Element des Arrays definiert die Anzahl von Elementen in der niederwertigsten Zifferngruppe direkt links vom CurrencyDecimalSeparator. Jedes nachfolgende Element verweist auf die nächste signifikante Zifferngruppe links von der vorherigen Gruppe. Wenn das letzte Element des Arrays ungleich 0 (null) ist, werden die verbleibenden Ziffern basierend auf dem letzten Element des Arrays gruppiert. Wenn das letzte Element 0 (null) ist, werden die verbleibenden Ziffern nicht gruppiert.

Wenn das Array z. B. {3, 4, 5} enthält, werden die Ziffern wie folgt gruppiert: "$55,55555,55555,55555,4444,333.00". Wenn das Array {3, 4, 0} enthält, werden die Ziffern wie folgt gruppiert: "$55555555555555555,4444,333.00".

Beispiel

Im folgenden Codebeispiel werden die Auswirkungen einer Änderung der CurrencyGroupSizes-Eigenschaft veranschaulicht.

Imports System
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 'Main 

End Class 'NumberFormatInfoSample

 

'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
*/
   
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
*/
import System.*;
import System.Globalization.*;

class NumberFormatInfoSample
{
    public static void main(String[] args)
    {
        // Gets a NumberFormatInfo associated with the en-US culture.
        NumberFormatInfo nfi = 
            (new CultureInfo("en-US", false)).get_NumberFormat();
        // Displays a value with the default separator (".").
        Int64 myInt = (Int64)123456789012345L;
        Console.WriteLine(myInt.ToString("C", nfi));
        // Displays the same value with different groupings.
        int mySizes1[] = { 2, 3, 4 };
        int mySizes2[] = { 2, 3, 0 };
        nfi.set_CurrencyGroupSizes(mySizes1);
        Console.WriteLine(myInt.ToString("C", nfi));
        nfi.set_CurrencyGroupSizes(mySizes2);
        Console.WriteLine(myInt.ToString("C", nfi));
    } //main 
} //NumberFormatInfoSample

/* 
This code produces the following output.

$123,456,789,012,345.00
$12,3456,7890,123,45.00
$1234567890,123,45.00
*/

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

NumberFormatInfo-Klasse
NumberFormatInfo-Member
System.Globalization-Namespace
NumberFormatInfo.CurrencyDecimalDigits-Eigenschaft
NumberFormatInfo.CurrencyDecimalSeparator-Eigenschaft
NumberFormatInfo.CurrencyGroupSeparator-Eigenschaft
CurrencySymbol
CurrencyNegativePattern
CurrencyPositivePattern
NumberGroupSizes
PercentGroupSizes