NumberFormatInfo.CurrencyGroupSeparator Propriedade

Definição

Namespace:

System.Globalization

Assembly:

System.Runtime.dll

Origem:

NumberFormatInfo.cs

Obtém ou define a cadeia de caracteres que separa grupos de dígitos à esquerda do decimal em valores de moeda.

public:
 property System::String ^ CurrencyGroupSeparator { System::String ^ get(); void set(System::String ^ value); };

public string CurrencyGroupSeparator { get; set; }

member this.CurrencyGroupSeparator : string with get, set

Public Property CurrencyGroupSeparator As String

Valor da propriedade

String

A cadeia de caracteres que separa grupos de dígitos à esquerda do decimal em valores de moeda. 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 CurrencyGroupSeparator 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( "C", nfi ) );
   
   // Displays the same value with a blank as the separator.
   nfi->CurrencyGroupSeparator = " ";
   Console::WriteLine( myInt.ToString( "C", 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( "C", nfi ) );

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

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

   End Sub

End Class

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

Comentários

O valor inicial dessa propriedade é derivado das configurações no item Regional e Language no Painel de Controle.

A CurrencyGroupSeparator propriedade é usada com a cadeia de caracteres de formato padrão "C" 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.

Confira também

• CurrencyDecimalDigits
• CurrencyDecimalSeparator
• CurrencyGroupSizes
• CurrencySymbol
• CurrencyNegativePattern
• CurrencyPositivePattern
• NumberGroupSeparator
• PercentGroupSeparator