• Article

NumberFormatInfo.PercentDecimalDigits Property

Microsoft Silverlight will reach end of support after October 2021. Learn more.

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

Namespace:  System.Globalization
Assembly:  mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Property PercentDecimalDigits As Integer

public int PercentDecimalDigits { get; set; }

Property Value

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

Exceptions

Exception Condition
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.

Examples

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

Imports System.Globalization

Class Example
   Public Shared Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock)
      ' Gets a NumberFormatInfo associated with the en-US culture.
      Dim nfi As NumberFormatInfo = New CultureInfo("en-US").NumberFormat

      ' Displays a negative value with the default number of decimal digits (2).
      Dim myInt As [Double] = 0.1234
      outputBlock.Text += String.Format(myInt.ToString("P", nfi)) & vbCrLf

      ' Displays the same value with four decimal digits.
      nfi.PercentDecimalDigits = 4
      outputBlock.Text += String.Format(myInt.ToString("P", nfi)) & vbCrLf
   End Sub 
End Class 
' This example produces the following output.
'       12.34 %
'       12.3400 %

using System;
using System.Globalization;

class Example
{
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      // Gets a NumberFormatInfo associated with the en-US culture.
      NumberFormatInfo nfi = new CultureInfo("en-US").NumberFormat;

      // Displays a negative value with the default number of decimal digits (2).
      Double myInt = 0.1234;
      outputBlock.Text += String.Format(myInt.ToString("P", nfi)) + "\n";

      // Displays the same value with four decimal digits.
      nfi.PercentDecimalDigits = 4;
      outputBlock.Text += String.Format(myInt.ToString("P", nfi)) + "\n";
   }
}
/* 
This example produces the following output.
   12.34 %
   12.3400 %
*/

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.