• Article

NumberFormatInfo.NumberDecimalDigits Property

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

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

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

Syntax

'Declaration
Public Property NumberDecimalDigits As Integer

public int NumberDecimalDigits { get; set; }

Property Value

Type: System.Int32
The number of decimal places to use in numeric 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 is read-only.

Examples

The following example demonstrates the effect of changing the NumberDecimalDigits 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 Int64 = -1234
      outputBlock.Text += String.Format(myInt.ToString("N", nfi)) & vbCrLf

      ' Displays the same value with four decimal digits.
      nfi.NumberDecimalDigits = 4
      outputBlock.Text += String.Format(myInt.ToString("N", nfi)) & vbCrLf

   End Sub  
End Class 'NumberFormatInfoSample
'
' This example produces the following output.
'       -1,234.00
'       -1,234.0000

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).
      Int64 myInt = -1234;
      outputBlock.Text += String.Format(myInt.ToString("N", nfi)) + "\n";

      // Displays the same value with four decimal digits.
      nfi.NumberDecimalDigits = 4;
      outputBlock.Text += String.Format(myInt.ToString("N", nfi)) + "\n";

   }
}


/* 
This code produces the following output.

-1,234.00
-1,234.0000
*/

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.