Freigeben über


NumberFormatInfo.PercentGroupSizes-Eigenschaft

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

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

Syntax

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

value = instance.PercentGroupSizes

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

/** @property */
public void set_PercentGroupSizes (int[] value)
public function get PercentGroupSizes () : int[]

public function set PercentGroupSizes (value : int[])

Eigenschaftenwert

Die Anzahl von Ziffern in jeder Gruppe links vom Dezimaltrennzeichen in Prozentangaben. 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 PercentDecimalSeparator. 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 PercentGroupSizes-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 [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 'Main 

End Class 'NumberFormatInfoSample


'This code produces the following output.

'

'12,345,678,901,234,600.00 %

'1234,5678,9012,346,00.00 %

'123456789012,346,00.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 (".").
      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 %
*/
   
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".").
   Double myInt = 123456789012345.6789;
   Console::WriteLine( myInt.ToString( "P", nfi ) );
   
   // Displays the same value with different groupings.
   array<Int32>^mySizes1 = {2,3,4};
   array<Int32>^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 %
*/
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 (".").
        System.Double myInt = (System.Double)123456789012346L;
        Console.WriteLine(myInt.ToString("P", nfi));
        // Displays the same value with different groupings.
        int mySizes1[] =  { 2, 3, 4 };
        int mySizes2[] =  { 2, 3, 0 };
        nfi.set_PercentGroupSizes(mySizes1);
        Console.WriteLine(myInt.ToString("P", nfi));
        nfi.set_PercentGroupSizes(mySizes2);
        Console.WriteLine(myInt.ToString("P", nfi));
    } //main 
} //NumberFormatInfoSample

/* 
This code produces the following output.

12,345,678,901,234,600.00 %
1234,5678,9012,346,00.00 %
123456789012,346,00.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.PercentDecimalDigits-Eigenschaft
NumberFormatInfo.PercentDecimalSeparator-Eigenschaft
NumberFormatInfo.PercentGroupSeparator-Eigenschaft
PercentSymbol
PercentNegativePattern
PercentPositivePattern
NumberFormatInfo.CurrencyGroupSizes-Eigenschaft
NumberFormatInfo.NumberGroupSizes-Eigenschaft