Export (0) Print
Expand All

Convert.ToInt32 Method (Object)

Converts the value of the specified object to a 32-bit signed integer.

Namespace:  System
Assemblies:   System.Runtime.Extensions (in System.Runtime.Extensions.dll)
  mscorlib (in mscorlib.dll)

public static int ToInt32(
	Object value
)

Parameters

value
Type: System.Object

An object that implements the IConvertible interface, or null.

Return Value

Type: System.Int32
A 32-bit signed integer equivalent to value, or zero if value is null.

ExceptionCondition
FormatException

value is not in an appropriate format.

InvalidCastException

value does not implement the IConvertible interface.

-or-

The conversion is not supported.

OverflowException

value represents a number that is less than Int32.MinValue or greater than Int32.MaxValue.

If value is not null, this method wraps a call to the IConvertible.ToInt32 implementation of the underlying type of value.

The following example attempts to convert each element in an object array to an integer.

object[] values = { true, -12, 163, 935, 'x', new DateTime(2009, 5, 12),
                    "104", "103.0", "-1",
                    "1.00e2", "One", 1.00e2, 16.3e42};
int result;

foreach (object value in values)
{
   try {
      result = Convert.ToInt32(value);
      Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                        value.GetType().Name, value,
                        result.GetType().Name, result);
   }
   catch (OverflowException) {
      Console.WriteLine("The {0} value {1} is outside the range of the Int32 type.",
                        value.GetType().Name, value);
   }                     
   catch (FormatException) {
      Console.WriteLine("The {0} value {1} is not in a recognizable format.",
                        value.GetType().Name, value);
   }
   catch (InvalidCastException) {
      Console.WriteLine("No conversion to an Int32 exists for the {0} value {1}.",
                        value.GetType().Name, value);

   }
}                           
// The example displays the following output: 
//    Converted the Boolean value True to the Int32 value 1. 
//    Converted the Int32 value -12 to the Int32 value -12. 
//    Converted the Int32 value 163 to the Int32 value 163. 
//    Converted the Int32 value 935 to the Int32 value 935. 
//    Converted the Char value x to the Int32 value 120. 
//    No conversion to an Int32 exists for the DateTime value 5/12/2009 12:00:00 AM. 
//    Converted the String value 104 to the Int32 value 104. 
//    The String value 103.0 is not in a recognizable format. 
//    Converted the String value -1 to the Int32 value -1. 
//    The String value 1.00e2 is not in a recognizable format. 
//    The String value One is not in a recognizable format. 
//    Converted the Double value 100 to the Int32 value 100. 
//    The Double value 1.63E+43 is outside the range of the Int32 type.

.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