C# BitConverter.ToUInt16用法及代碼示例

此方法用於返回從字節數組中指定位置的兩個字節轉換而來的16位無符號整數。

用法:

public static ushort ToUInt16 (byte[] value, int startIndex);

參數：

value:它是一個字節數組。
startIndex:它是值內的起始位置。

返回值：此方法返回一個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/en-us/dotnet/api/system.bitconverter.touint16?view=netframework-4.7.2

相關用法

注：本文由純淨天空篩選整理自RohitPrasad3大神的英文原創作品 C# | BitConverter.ToUInt16 Method。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。