Esta documentación está archivada y no tiene mantenimiento.

NumberFormatInfo.NumberGroupSizes (Propiedad)

Obtiene o establece el número de dígitos en cada grupo a la izquierda de la coma decimal en valores numéricos.

Espacio de nombres: System.Globalization
Ensamblado: mscorlib (en mscorlib.dll)

public int[] NumberGroupSizes { get; set; }
/** @property */
public int[] get_NumberGroupSizes ()

/** @property */
public void set_NumberGroupSizes (int[] value)

public function get NumberGroupSizes () : int[]

public function set NumberGroupSizes (value : int[])

Valor de propiedad

Número de dígitos en cada grupo a la izquierda de la coma decimal en valores numéricos. El valor predeterminado de InvariantInfo es una matriz de una dimensión con un único elemento, que se establece en 3.

Tipo de excepciónCondición

ArgumentNullException

La propiedad se establece en referencia de objeto null (Nothing en Visual Basic).

ArgumentException

La propiedad se establece y la matriz contiene una entrada que es menor que 0 o mayor que 9.

O bien

La propiedad se establece y la matriz contiene una entrada, distinta de la última entrada, que se establece en 0.

InvalidOperationException

La propiedad se establece y NumberFormatInfo es de sólo lectura.

Cada elemento de la matriz de una dimensión debe ser un entero entre 1 y 9. El último elemento puede ser 0.

El primer elemento de la matriz define el número de elementos en el grupo de dígitos menos significativo inmediatamente a la izquierda de NumberDecimalSeparator. Cada elemento subsiguiente hace referencia al siguiente grupo de dígitos significativo a la izquierda del grupo anterior. Si el último elemento de la matriz no es 0, los dígitos restantes se agrupan basándose en el último elemento de la matriz. Si el último elemento es 0, los dígitos restantes no se agrupan.

Por ejemplo, si la matriz contiene {3, 4, 5}, los dígitos se agruparán de una forma parecida a "55,55555,55555,55555,4444,333.00". Si la matriz contiene {3, 4, 0}, los dígitos se agruparán de una forma parecida a "55555555555555555,4444,333.00".

En el siguiente ejemplo de código se muestra el efecto de cambiar la propiedad NumberGroupSizes.

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( "N", nfi ) );

      // Displays the same value with different groupings.
      int[] mySizes1 = {2,3,4};
      int[] mySizes2 = {2,3,0};
      nfi.NumberGroupSizes = mySizes1;
      Console.WriteLine( myInt.ToString( "N", nfi ) );
      nfi.NumberGroupSizes = mySizes2;
      Console.WriteLine( myInt.ToString( "N", 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("N", nfi));
        // Displays the same value with different groupings.
        int mySizes1[] =  { 2, 3, 4 };
        int mySizes2[] =  { 2, 3, 0 };
        nfi.set_NumberGroupSizes(mySizes1);
        Console.WriteLine(myInt.ToString("N", nfi));
        nfi.set_NumberGroupSizes(mySizes2);
        Console.WriteLine(myInt.ToString("N", 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
*/


En el siguiente ejemplo de código se imprime un valor utilizando matrices NumberGroupSizes diferentes.

using System;
using System.Globalization;
class SamplesNumberFormatInfo  {

   public static void Main()  {

      // Creates a new NumberFormatinfo.
      NumberFormatInfo myNfi = new NumberFormatInfo();

      // Takes a long value.
      Int64 myInt = 123456789012345;

      // Displays the value with default formatting.
      Console.WriteLine( "Default  \t\t:\t{0}", myInt.ToString( "N", myNfi ) );

      // Displays the value with three elements in the GroupSize array.
      myNfi.NumberGroupSizes = new int[]  { 2, 3, 4 };
      Console.WriteLine( "Grouping ( {0} )\t:\t{1}",
         PrintArraySet( myNfi.NumberGroupSizes ), myInt.ToString( "N", myNfi ) );

      // Displays the value with zero as the last element in the GroupSize array.
      myNfi.NumberGroupSizes = new int[]  { 2, 4, 0 };
      Console.WriteLine( "Grouping ( {0} )\t:\t{1}",
         PrintArraySet( myNfi.NumberGroupSizes ), myInt.ToString( "N", myNfi ) );
   }

   public static string PrintArraySet( int[] myArr )  {
      string myStr = null;
      myStr = myArr[0].ToString();
      for ( int i = 1; i < myArr.Length; i++ )
         myStr += ", " + myArr[i].ToString();
      return( myStr );
   }
}
/*
This code produces the following output. 

Default                 :       123,456,789,012,345.00
Grouping ( 2, 3, 4 )    :       12,3456,7890,123,45.00
Grouping ( 2, 4, 0 )    :       123456789,0123,45.00
*/

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

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

.NET Framework

Compatible con: 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 2.0, 1.0
Mostrar: