Convert.ToInt32 Method (Int64)

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

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

public static int ToInt32(
	long value
)

Parameters

value
Type: System.Int64

The 64-bit signed integer to convert.

Return Value

Type: System.Int32
A 32-bit signed integer that is equivalent to value.

ExceptionCondition
OverflowException

value is greater than Int32.MaxValue or less than Int32.MinValue.

The following example attempts to convert each element in an array of long integers to an integer.

long[] numbers = { Int64.MinValue, -1, 0, 121, 340, Int64.MaxValue };
int result;
foreach (long number in numbers)
{
   try {
      result = Convert.ToInt32(number);
      Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                        number.GetType().Name, number,
                        result.GetType().Name, result);
   }
   catch (OverflowException) {
      Console.WriteLine("The {0} value {1} is outside the range of the Int32 type.",
                        number.GetType().Name, number);
   }
}
// The example displays the following output: 
//    The Int64 value -9223372036854775808 is outside the range of the Int32 type. 
//    Converted the Int64 value -1 to the Int32 value -1. 
//    Converted the Int64 value 0 to the Int32 value 0. 
//    Converted the Int64 value 121 to the Int32 value 121. 
//    Converted the Int64 value 340 to the Int32 value 340. 
//    The Int64 value 9223372036854775807 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

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone Silverlight 8.1, Windows Phone Silverlight 8

Portable Class Library

Supported in: Portable Class Library
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft