Convert.ToInt16 Method (Object)
.NET Framework (current version)
Converts the value of the specified object to a 16-bit signed integer.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- value
-
Type:
System.Object
An object that implements the IConvertible interface, or null.
Return Value
Type: System.Int16A 16-bit signed integer that is equivalent to value, or zero if value is null.
| Exception | Condition |
|---|---|
| FormatException | value is not in an appropriate format for an Int16 type. |
| InvalidCastException | |
| OverflowException | value represents a number that is less than Int16.MinValue or greater than Int16.MaxValue. |
If value is not null, this method wraps a call to the IConvertible.ToInt16 implementation of the underlying type of value.
The following example attempts to convert each element in an object array to a 16-bit signed integer.
Dim values() As Object = { True, -12, 163, 935, "x"c, #5/12/2009#, _ "104", "103.0", "-1", _ "1.00e2", "One", 1.00e2} Dim result As Short For Each value As Object In values Try result = Convert.ToInt16(value) Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.", _ value.GetType().Name, value, _ result.GetType().Name, result) Catch e As OverflowException Console.WriteLine("The {0} value {1} is outside the range of the Int16 type.", _ value.GetType().Name, value) Catch e As FormatException Console.WriteLine("The {0} value {1} is not in a recognizable format.", _ value.GetType().Name, value) Catch e As InvalidCastException Console.WriteLine("No conversion to an Int16 exists for the {0} value {1}.", _ value.GetType().Name, value) End Try Next ' The example displays the following output: ' Converted the Boolean value True to the Int16 value 1. ' Converted the Int32 value -12 to the Int16 value -12. ' Converted the Int32 value 163 to the Int16 value 163. ' Converted the Int32 value 935 to the Int16 value 935. ' Converted the Char value x to the Int16 value 120. ' No conversion to an Int16 exists for the DateTime value 5/12/2009 12:00:00 AM. ' Converted the String value 104 to the Int16 value 104. ' The String value 103.0 is not in a recognizable format. ' Converted the String value -1 to the Int16 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 Int16 value 100.
Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Show: