Int32.MaxValue Field (System)

.NET Framework Class Library

Int32..::.MaxValue Field

Represents the largest possible value of an Int32. This field is constant.

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

Syntax

Visual Basic (Declaration)

Public Const MaxValue As Integer

Visual Basic (Usage)

Dim value As Integer

value = Integer.MaxValue

public const int MaxValue

Visual C++

public:
literal int MaxValue

JScript

public const var MaxValue : int

Remarks

The value of this constant is 2,147,483,647; that is, hexadecimal 0x7FFFFFFF.

Examples

The following example uses the MaxValue field to prevent an OverflowException when converting to an Int32 value.

Visual Basic

Dim numbersToConvert() As Long = { 162345, 32183, -54000, Int64.MaxValue\2 }
Dim newNumber As Integer
For Each number As Long In NumbersToConvert
   If number >= Int32.MinValue And number <= Int32.MaxValue Then
      newNumber = Convert.ToInt32(number)
      Console.WriteLine("Successfully converted {0} to an Int32.", _
                        newNumber)
   Else
      Console.WriteLine("Unable to convert {0} to an Int32.", number)
   End If                     
Next
' The example displays the following output to the console:
'       Successfully converted 162345 to an Int32.
'       Successfully converted 32183 to an Int32.
'       Successfully converted -54000 to an Int32.
'       Unable to convert 4611686018427387903 to an Int32.

long[] numbersToConvert = { 162345, 32183, -54000, Int64.MaxValue/2 };
int newNumber;
foreach (long number in numbersToConvert)
{
   if (number >= Int32.MinValue && number <= Int32.MaxValue)
   {
      newNumber = Convert.ToInt32(number);
      Console.WriteLine("Successfully converted {0} to an Int32.", 
                        newNumber);
   }
   else
   {
      Console.WriteLine("Unable to convert {0} to an Int32.", number);
   }
}
// The example displays the following output to the console:
//    Successfully converted 162345 to an Int32.
//    Successfully converted 32183 to an Int32.
//    Successfully converted -54000 to an Int32.
//    Unable to convert 4611686018427387903 to an Int32.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360, Zune

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0

XNA Framework

Supported in: 3.0, 2.0, 1.0

Reference