此方法用于返回从字节数组中指定位置的两个字节转换而来的16位无符号整数。
句法：
public static ushort ToUInt16 (byte[] value, int startIndex);参数：
value: It is an array of bytes.
startIndex: It is the starting position within value.
返回值：该方法返回一个16位无符号整数，该整数由两个字节组成，从startIndex开始。
例外情况：
- ArgumentException：如果startIndex等于字节的长度减去1。
- ArgumentNullException：如果字节为null。
- ArgumentOutOfRangeException：如果startIndex小于零或大于字节的长度减去1。
下面的程序说明了BitConverter.ToUInt16方法的用法：
范例1：
// C# program to demonstrate
// BitConverter.ToUInt16(Byte[], Int32);
// Method
using System;
class GFG {
// Main Method
public static void Main()
{
try {
// Define an array of byte values.
byte[] bytes = {32, 0, 0, 42, 0, 65,
0, 125, 0, 197, 0,
168, 3, 41, 4, 125,
32};
// Display the values of the myArr.
Console.Write("Initial Array: ");
// calling the PrintIndexAndValues()
// method to print
PrintIndexAndValues(bytes);
// print char value
Console.WriteLine("index byte Array ushort value");
for (int index = 0; index < bytes.Length - 1;
index = index + 2) {
ushort values = BitConverter.ToUInt16(bytes, index);
Console.WriteLine(" {0} {1} {2}",
index, BitConverter.ToString(bytes,
index, 2), values);
}
}
catch (ArgumentNullException e) {
Console.Write("Exception Thrown: ");
Console.Write("{0}", e.GetType(), e.Message);
}
catch (ArgumentOutOfRangeException e) {
Console.Write("Exception Thrown: ");
Console.Write("{0}", e.GetType(), e.Message);
}
catch (ArgumentException e) {
Console.Write("Exception Thrown: ");
Console.Write("{0}", e.GetType(), e.Message);
}
}
// Defining the method
// PrintIndexAndValues
public static void PrintIndexAndValues(byte[] myArr)
{
for (int i = 0; i < myArr.Length; i++) {
Console.Write("{0} ", myArr[i]);
}
Console.WriteLine();
Console.WriteLine();
}
}
输出：
Initial Array: 32 0 0 42 0 65 0 125 0 197 0 168 3 41 4 125 32
index byte Array ushort value
0 20-00 32
2 00-2A 10752
4 00-41 16640
6 00-7D 32000
8 00-C5 50432
10 00-A8 43008
12 03-29 10499
14 04-7D 32004
示例2：对于ArgumentException
// C# program to demonstrate
// BitConverter.ToUInt16(Byte[], Int32);
// Method
using System;
class GFG {
// Main Method
public static void Main()
{
try {
// Define an array of byte values.
byte[] bytes = {32, 0, 0, 42, 0, 65,
0, 125, 0, 197, 0,
168, 3, 41, 4, 125 };
// Display the values of the myArr.
Console.Write("Initial Array: ");
// calling the PrintIndexAndValues()
// method to print
PrintIndexAndValues(bytes);
// print char value
Console.WriteLine("index element ushot value");
for (int index = 1; index < bytes.Length;
index = index + 2) {
if (index == bytes.Length - 1) {
Console.WriteLine();
Console.WriteLine("startindex is {0} which is equals to "+
"the length of Array minus 1.", index);
ushort values = BitConverter.ToUInt16(bytes, index);
Console.WriteLine(" {0} {1} {2}",
index, BitConverter.ToString(bytes,
index, 2), values);
}
else {
ushort values = BitConverter.ToUInt16(bytes, index);
Console.WriteLine(" {0} {1} {2}",
index, BitConverter.ToString(bytes,
index, 2), values);
}
}
}
catch (ArgumentNullException e) {
Console.Write("Exception Thrown: ");
Console.Write("{0}", e.GetType(), e.Message);
}
catch (ArgumentOutOfRangeException e) {
Console.Write("Exception Thrown: ");
Console.Write("{0}", e.GetType(), e.Message);
}
catch (ArgumentException e) {
Console.Write("Exception Thrown: ");
Console.Write("{0}", e.GetType(), e.Message);
}
}
// Defining the method
// PrintIndexAndValues
public static void PrintIndexAndValues(byte[] myArr)
{
for (int i = 0; i < myArr.Length; i++) {
Console.Write("{0} ", myArr[i]);
}
Console.WriteLine();
Console.WriteLine();
Console.WriteLine("intial Array in string: {0} ",
BitConverter.ToString(myArr));
Console.WriteLine();
}
}
输出：
Initial Array: 32 0 0 42 0 65 0 125 0 197 0 168 3 41 4 125
intial Array in string: 20-00-00-2A-00-41-00-7D-00-C5-00-A8-03-29-04-7D
index element ushot value
1 00-00 0
3 2A-00 42
5 41-00 65
7 7D-00 125
9 C5-00 197
11 A8-03 936
13 29-04 1065
startindex is 15 which is equals to the length of Array minus 1.
Exception Thrown: System.ArgumentException
示例3：对于ArgumentOutOfRangeException
// C# program to demonstrate
// BitConverter.ToUInt16(Byte[], Int32);
// Method
using System;
class GFG {
// Main Method
public static void Main()
{
try {
// Define an array of byte values.
byte[] bytes = {32, 0, 0, 42, 0, 65, 0, 125, 0,
197, 0, 168, 3, 41, 4, 125};
// Display the values of the myArr.
Console.Write("Initial Array: ");
// calling the PrintIndexAndValues()
// method to print
PrintIndexAndValues(bytes);
// print char value
Console.WriteLine("index element ushot value");
for (int index = 0; index < bytes.Length + 1;
index = index + 2) {
if (index == bytes.Length) {
Console.WriteLine();
Console.WriteLine("startindex is {0} which is greater than "+
"the length of Array minus 1.", index);
ushort values = BitConverter.ToUInt16(bytes, index);
Console.WriteLine(" {0} {1} {2}",
index, BitConverter.ToString(bytes,
index, 2), values);
}
else {
ushort values = BitConverter.ToUInt16(bytes, index);
Console.WriteLine(" {0} {1} {2}",
index, BitConverter.ToString(bytes,
index, 2), values);
}
}
}
catch (ArgumentNullException e) {
Console.Write("Exception Thrown: ");
Console.Write("{0}", e.GetType(), e.Message);
}
catch (ArgumentOutOfRangeException e) {
Console.Write("Exception Thrown: ");
Console.Write("{0}", e.GetType(), e.Message);
}
catch (ArgumentException e) {
Console.Write("Exception Thrown: ");
Console.Write("{0}", e.GetType(), e.Message);
}
}
// Defining the method
// PrintIndexAndValues
public static void PrintIndexAndValues(byte[] myArr)
{
for (int i = 0; i < myArr.Length; i++) {
Console.Write("{0} ", myArr[i]);
}
Console.WriteLine();
Console.WriteLine();
Console.WriteLine("intial Array in string: {0} ",
BitConverter.ToString(myArr));
Console.WriteLine();
}
}
输出：
Initial Array: 32 0 0 42 0 65 0 125 0 197 0 168 3 41 4 125
intial Array in string: 20-00-00-2A-00-41-00-7D-00-C5-00-A8-03-29-04-7D
index element ushot value
0 20-00 32
2 00-2A 10752
4 00-41 16640
6 00-7D 32000
8 00-C5 50432
10 00-A8 43008
12 03-29 10499
14 04-7D 32004
startindex is 16 which is greater than the length of Array minus 1.
Exception Thrown: System.ArgumentOutOfRangeException
示例4：对于ArgumentNullException
// C# program to demonstrate
// BitConverter.ToUInt16(Byte[], Int32);
// Method
using System;
class GFG {
// Main Method
public static void Main()
{
try {
// Define an array of byte values.
byte[] bytes = null;
// get the long value
ushort values = BitConverter.ToUInt16(bytes, 0);
Console.Write("{0}", values);
}
catch (ArgumentNullException e) {
Console.Write("Exception Thrown: ");
Console.Write("{0}", e.GetType(), e.Message);
}
catch (ArgumentOutOfRangeException e) {
Console.Write("Exception Thrown: ");
Console.Write("{0}", e.GetType(), e.Message);
}
catch (ArgumentException e) {
Console.Write("Exception Thrown: ");
Console.Write("{0}", e.GetType(), e.Message);
}
}
}
输出：
Exception Thrown: System.ArgumentNullException
参考：
- https://docs.microsoft.com/zh-cn/dotnet/api/system.bitconverter.touint16?view=netframework-4.7.2