BitConverter.ToUInt16 Method
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Returns a 16-bit unsigned integer converted from two bytes at a specified position in a byte array.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- value
- Type:
System.Byte
[]
The array of bytes.
- startIndex
- Type: System.Int32
The starting position within value.
Return Value
Type: System.UInt16A 16-bit unsigned integer formed by two bytes beginning at startIndex.
| Exception | Condition |
|---|---|
| ArgumentException | startIndex equals the length of value minus 1. |
| ArgumentNullException | value is null. |
| ArgumentOutOfRangeException | startIndex is less than zero or greater than the length of value minus 1. |
The following code example converts elements of Byte arrays to UInt16 values with the ToUInt16 method.
// Example of the BitConverter.ToUInt16 method. using System; class Example { const string formatter = "{0,5}{1,17}{2,10}"; // Convert two byte array elements to a ushort and display it. public static void BAToUInt16(System.Windows.Controls.TextBlock outputBlock, byte[] bytes, int index) { ushort value = BitConverter.ToUInt16(bytes, index); outputBlock.Text += String.Format(formatter, index, BitConverter.ToString(bytes, index, 2), value) + "\n"; } public static void Demo(System.Windows.Controls.TextBlock outputBlock) { byte[] byteArray = { 15, 0, 0, 255, 3, 16, 39, 255, 255, 127 }; outputBlock.Text += String.Format( "This example of the BitConverter.ToUInt16( byte[ ], " + "int ) \nmethod generates the following output. It " + "converts elements \nof a byte array to ushort values.\n") + "\n"; outputBlock.Text += "initial byte array" + "\n"; outputBlock.Text += "------------------" + "\n"; outputBlock.Text += BitConverter.ToString(byteArray) + "\n"; outputBlock.Text += "\n"; outputBlock.Text += String.Format(formatter, "index", "array elements", "ushort") + "\n"; outputBlock.Text += String.Format(formatter, "-----", "--------------", "------") + "\n"; // Convert byte array elements to ushort values. BAToUInt16(outputBlock, byteArray, 1); BAToUInt16(outputBlock, byteArray, 0); BAToUInt16(outputBlock, byteArray, 3); BAToUInt16(outputBlock, byteArray, 5); BAToUInt16(outputBlock, byteArray, 8); BAToUInt16(outputBlock, byteArray, 7); } } /* This example of the BitConverter.ToUInt16( byte[ ], int ) method generates the following output. It converts elements of a byte array to ushort values. initial byte array ------------------ 0F-00-00-FF-03-10-27-FF-FF-7F index array elements ushort ----- -------------- ------ 1 00-00 0 0 0F-00 15 3 FF-03 1023 5 10-27 10000 8 FF-7F 32767 7 FF-FF 65535 */
Show: