NumberFormatInfo.NumberGroupSeparator Propriedade

Referência

Definição

Namespace:: System.Globalization

Assembly:: System.Globalization.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Origem:: NumberFormatInfo.cs

Origem:: NumberFormatInfo.cs

Origem:: NumberFormatInfo.cs

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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 em Painel de Controle.

Aplica-se a

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Compartilhar via