Int16.MinValue Field (System)

.NET Framework Class Library

Int16..::.MinValue Field

Represents the smallest possible value of Int16. This field is constant.

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

Syntax

Visual Basic (Declaration)

Public Const MinValue As Short

Visual Basic (Usage)

Dim value As Short

value = Short.MinValue

public const short MinValue

Visual C++

public:
literal short MinValue

JScript

public const var MinValue : short

Remarks

The value of this constant is -32768; that is, hexadecimal 0x8000.

The MinValue property is typically used to prevent an OverflowException when converting from a numeric type with a greater lower range (such as an Int32 or an Int64) to an Int16. The example illustrates this usage.

Examples

The following example uses the MinValue property to prevent an OverflowException when converting to an Int16 value.

Visual Basic

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

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

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