Int16.MinValue Field

Reference

Definition

Namespace:: System

Assemblies:: mscorlib.dll, System.Runtime.dll

Assemblies:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Source:: Int16.cs

Source:: Int16.cs

Source:: Int16.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

public: short MinValue = -32768;

public const short MinValue = -32768;

val mutable MinValue : int16

Public Const MinValue As Short  = -32768

Field Value

Value = -32768

Int16

Examples

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

array<Int64>^ numbersToConvert = {162345, 32183, -54000};
Int16 newNumber;
for each (Int64 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:
//       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 {newNumber} to an Int16.");
   }
   else
   {
      Console.WriteLine($"Unable to convert {number} to an Int16.");
   }
}
// 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.

open System

let numbersToConvert = [ 162345L; 32183L; -54000L ]

for number in numbersToConvert do
    if number >= int64 Int16.MinValue && number <= int64 Int16.MaxValue then
        let newNumber = Convert.ToInt16 number
        printfn $"Successfully converted {newNumber} to an Int16."
    else
        printfn $"Unable to convert {number} to an Int16."

// 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.

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.

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.

Applies to

Product	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Share via