Export (0) Print
Expand All

NumberFormatInfo.NumberDecimalDigits Property

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

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

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.

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 NumberDecimalDigits property is used with the "F" and "N" standard format strings 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 NumberDecimalDigits property.

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 negative value with the default number of decimal digits (2).
      Int64 myInt = -1234;
      Console.WriteLine( myInt.ToString( "N", nfi ) );

      // Displays the same value with four decimal digits.
      nfi.NumberDecimalDigits = 4;
      Console.WriteLine( myInt.ToString( "N", nfi ) );

   }
}


/* 
This code produces the following output.

-1,234.00
-1,234.0000
*/
   

.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Show:
© 2015 Microsoft