NumberFormatInfo.NumberGroupSeparator Propriedade

  • Referência

Definição

Namespace:
System.Globalization
Assembly:
System.Globalization.dll
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll
Assembly:
mscorlib.dll

Obtém ou define a cadeia de caracteres que separa grupos de dígitos à esquerda da vírgula decimal em valores numéricos.

public:
 property System::String ^ NumberGroupSeparator { System::String ^ get(); void set(System::String ^ value); };
public string NumberGroupSeparator { get; set; }
member this.NumberGroupSeparator : string with get, set
Public Property NumberGroupSeparator As String

Valor da propriedade

String

A cadeia de caracteres que separa grupos de dígitos à esquerda da vírgula decimal em valores numéricos. O padrão para InvariantInfo é ".".

Exceções

ArgumentNullException

A propriedade está sendo definida como null.

InvalidOperationException

A propriedade está sendo definida e o objeto NumberFormatInfo é somente leitura.

Exemplos

O exemplo a seguir demonstra o efeito da alteração da NumberGroupSeparator propriedade.

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 = 123456789;
   Console::WriteLine( myInt.ToString( "N", nfi ) );
   
   // Displays the same value with a blank as the separator.
   nfi->NumberGroupSeparator = " ";
   Console::WriteLine( myInt.ToString( "N", nfi ) );
}

/*
This code produces the following output.
123, 456, 789.00
123 456 789.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 = 123456789;
      Console.WriteLine( myInt.ToString( "N", nfi ) );

      // Displays the same value with a blank as the separator.
      nfi.NumberGroupSeparator = " ";
      Console.WriteLine( myInt.ToString( "N", nfi ) );
   }
}


/*
This code produces the following output.

123,456,789.00
123 456 789.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 = 123456789
      Console.WriteLine(myInt.ToString("N", nfi))

      ' Displays the same value with a blank as the separator.
      nfi.NumberGroupSeparator = " "
      Console.WriteLine(myInt.ToString("N", nfi))

   End Sub

End Class


'This code produces the following output.
'
'123,456,789.00
'123 456 789.00

Comentários

A NumberGroupSeparator propriedade é usada com a cadeia de caracteres de formato padrão "N" para definir o símbolo que separa grupos de dígitos integrais. Para obter mais informações, confira Cadeias de caracteres de formato numérico padrão.

O valor inicial dessa propriedade é derivado das configurações no item região e idioma no painel de controle.

Aplica-se a

Confira também