C# | Método BitConverter.ToUInt16

Este método se usa para devolver un entero sin signo de 16 bits convertido a partir de dos bytes en una posición específica en una array de bytes.
Sintaxis: 
 

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

Parámetros:
 

valor: Es una array de bytes. 
startIndex: Es la posición inicial dentro del valor. 
 

Valor devuelto: este método devuelve un entero sin signo de 16 bits formado por dos bytes que comienzan en startIndex .
Excepciones: 
 

  • ArgumentException: si startIndex es igual a la longitud de bytes menos 1.
  • ArgumentNullException: si los bytes son nulos.
  • ArgumentOutOfRangeException: si startIndex es menor que cero o mayor que la longitud de bytes menos 1.

Los siguientes programas ilustran el uso del método BitConverter.ToUInt16 :
Ejemplo 1:
 

CSHARP

// 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();
    }
}
Producción: 

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

 

Ejemplo 2: para ArgumentException
 

CSHARP

// 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("initial Array in string: {0} ",
                           BitConverter.ToString(myArr));
        Console.WriteLine();
    }
}
Producción

Initial Array: 32 0 0 42 0 65 0 125 0 197 0 168 3 41 4 125 

initial 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

Ejemplo 3: para ArgumentOutOfRangeException
 

CSHARP

// 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("initial Array in string: {0} ",
                           BitConverter.ToString(myArr));
        Console.WriteLine();
    }
}
Producción

Initial Array: 32 0 0 42 0 65 0 125 0 197 0 168 3 41 4 125 

initial 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

Ejemplo 4: Para ArgumentNullException
 

CSHARP

// 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);
        }
    }
}
Producción: 

Exception Thrown: System.ArgumentNullException

 

Referencia: 
 

Publicación traducida automáticamente

Artículo escrito por RohitPrasad3 y traducido por Barcelona Geeks. The original can be accessed here. Licence: CCBY-SA

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *