This topic has not yet been rated - Rate this topic

Decimal.ToInt32 Method

Other Versions

Converts the value of the specified Decimal to the equivalent 32-bit signed integer.

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

Syntax

Copy

[SecuritySafeCriticalAttribute]
public static int ToInt32(
	decimal d
)

Parameters

d: Type: System.Decimal
The Decimal value to convert.

Return Value

Type: System.Int32
A 32-bit signed integer equivalent to the value of d.

Exceptions

Exception	Condition
OverflowException	d is less than Int32.MinValue or greater than Int32.MaxValue.

Remarks

The return value is the integral part of the decimal value; fractional digits are truncated.

Examples

The following code example converts Decimal numbers to Int32 values using the ToInt32 method.

Copy


// Example of the decimal.ToInt32 and decimal.ToUInt32 methods.
using System;

class Example
{
   const string formatter = "{0,17}{1,19}{2,19}";

   // Get the exception type name; remove the namespace prefix.
   public static string GetExceptionType(Exception ex)
   {
      string exceptionType = ex.GetType().ToString();
      return exceptionType.Substring(
          exceptionType.LastIndexOf('.') + 1);
   }

   // Convert the decimal argument; catch exceptions that are thrown.
   public static void DecimalToU_Int32(System.Windows.Controls.TextBlock outputBlock, decimal argument)
   {
      object Int32Value;
      object UInt32Value;

      // Convert the argument to an int value.
      try
      {
         Int32Value = decimal.ToInt32(argument);
      }
      catch (Exception ex)
      {
         Int32Value = GetExceptionType(ex);
      }

      // Convert the argument to a uint value.
      try
      {
         UInt32Value = decimal.ToUInt32(argument);
      }
      catch (Exception ex)
      {
         UInt32Value = GetExceptionType(ex);
      }

      outputBlock.Text += String.Format(formatter, argument,
          Int32Value, UInt32Value) + "\n";
   }

   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      outputBlock.Text += String.Format("This example of the \n" +
          "  decimal.ToInt32( decimal ) and \n" +
          "  decimal.ToUInt32( decimal ) \nmethods " +
          "generates the following output. It \ndisplays " +
          "several converted decimal values.\n") + "\n";
      outputBlock.Text += String.Format(formatter, "decimal argument",
          "int/exception", "uint/exception") + "\n";
      outputBlock.Text += String.Format(formatter, "----------------",
          "-------------", "--------------") + "\n";

      // Convert decimal values and display the results.
      DecimalToU_Int32(outputBlock, 123M);
      DecimalToU_Int32(outputBlock, new decimal(123000, 0, 0, false, 3));
      DecimalToU_Int32(outputBlock, 123.999M);
      DecimalToU_Int32(outputBlock, 4294967295.999M);
      DecimalToU_Int32(outputBlock, 4294967296M);
      DecimalToU_Int32(outputBlock, 2147483647.999M);
      DecimalToU_Int32(outputBlock, 2147483648M);
      DecimalToU_Int32(outputBlock, -0.999M);
      DecimalToU_Int32(outputBlock, -1M);
      DecimalToU_Int32(outputBlock, -2147483648.999M);
      DecimalToU_Int32(outputBlock, -2147483649M);
   }
}

/*
This example of the
  decimal.ToInt32( decimal ) and
  decimal.ToUInt32( decimal )
methods generates the following output. It
displays several converted decimal values.

 decimal argument      int/exception     uint/exception
 ----------------      -------------     --------------
              123                123                123
          123.000                123                123
          123.999                123                123
   4294967295.999  OverflowException         4294967295
       4294967296  OverflowException  OverflowException
   2147483647.999         2147483647         2147483647
       2147483648  OverflowException         2147483648
           -0.999                  0                  0
               -1                 -1  OverflowException
  -2147483648.999        -2147483648  OverflowException
      -2147483649  OverflowException  OverflowException
*/