This topic has not yet been rated - Rate this topic

NumberFormatInfo::PercentDecimalDigits Property

Gets or sets the number of decimal places to use in percent values.

Namespace:  System.Globalization
Assembly:  mscorlib (in mscorlib.dll)
public:
property int PercentDecimalDigits {
	int get ();
	void set (int value);
}

Property Value

Type: System::Int32
The number of decimal places to use in percent values. The default for InvariantInfo is 2.
ExceptionCondition
ArgumentOutOfRangeException

The property is being set to a value that is less than 0 or greater than 99.

InvalidOperationException

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

The PercentDecimalDigits property is used with the "P" standard format string without a precision specifier in numeric formatting operations. It defines the default number of fractional digits that appear after the decimal separator. This value is overridden if a precision specifier is used. For more information, see Standard Numeric Format Strings.

The following example demonstrates the effect of changing the PercentDecimalDigits 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 negative value with the default number of decimal digits (2).
   Double myInt = 0.1234;
   Console::WriteLine( myInt.ToString( "P", nfi ) );

   // Displays the same value with four decimal digits.
   nfi->PercentDecimalDigits = 4;
   Console::WriteLine( myInt.ToString( "P", nfi ) );
}

/*
This code produces the following output.
12.34 %
12.3400 %
*/

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.