NumberFormatInfo.PercentGroupSeparator Property

Reference

Definition

Namespace:: System.Globalization

Assembly:: System.Globalization.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Source:: NumberFormatInfo.cs

Source:: NumberFormatInfo.cs

Source:: NumberFormatInfo.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets the string that separates groups of digits to the left of the decimal in percent values.

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

public string PercentGroupSeparator { get; set; }

member this.PercentGroupSeparator : string with get, set

Public Property PercentGroupSeparator As String

Property Value

String

The string that separates groups of digits to the left of the decimal in percent values. The default for InvariantInfo is ",".

Exceptions

ArgumentNullException

The property is being set to null.

InvalidOperationException

The property is being set and the NumberFormatInfo object is read-only.

Examples

The following example demonstrates the effect of changing the PercentGroupSeparator property.

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

/*
This code produces the following output.
123, 456.78 %
123 456.78 %
*/

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 = 1234.5678;
      Console.WriteLine( myInt.ToString( "P", nfi ) );

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


/*
This code produces the following output.

123,456.78 %
123 456.78 %
*/

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] = 1234.5678
      Console.WriteLine(myInt.ToString("P", nfi))

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

   End Sub

End Class


'This code produces the following output.
'
'123,456.78 %
'123 456.78 %

Remarks

The PercentGroupSeparator property is used with the "P" standard format string to define the symbol that separates groups of integers. For more information, see Standard Numeric Format Strings.

Applies to

Jaa