Convert.ToByte Method (UInt16)
.NET Framework (current version)
Converts the value of the specified 16-bit unsigned integer to an equivalent 8-bit unsigned integer.
This API is not CLS-compliant.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- value
-
Type:
System.UInt16
The 16-bit unsigned integer to convert.
| Exception | Condition |
|---|---|
| OverflowException | value is greater than Byte.MaxValue. |
The following example converts an array of unsigned 16-bit integers to Byte values.
Dim numbers() As UShort = { UInt16.MinValue, 121, 340, UInt16.MaxValue } Dim result As Byte For Each number As UShort In numbers Try result = Convert.ToByte(number) Console.WriteLIne("Converted the {0} value {1} to the {2} value {3}.", _ number.GetType().Name, number, _ result.GetType().Name, result) Catch e As OverflowException Console.WriteLine("The {0} value {1} is outside the range of the Byte type.", _ number.GetType().Name, number) End Try Next ' The example displays the following output: ' Converted the UInt16 value 0 to the Byte value 0. ' Converted the UInt16 value 121 to the Byte value 121. ' The UInt16 value 340 is outside the range of the Byte type. ' The UInt16 value 65535 is outside the range of the Byte type.
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: