C# | Método Convert.ToUInt16(String, IFormatProvider)

Este método se usa para convertir la representación de string especificada de un número en un entero sin signo de 16 bits equivalente, usando la información de formato específica de la referencia cultural especificada.
 

Sintaxis:  

ushort estático público ToUInt16 (valor de string, proveedor IFormatProvider);

Parámetros:  

• valor: Es una string que contiene el número a convertir.
• proveedor: es un objeto que proporciona información de formato específica de la cultura.

Valor devuelto : este método devuelve un entero sin signo de 16 bits que es equivalente al número en valor, o 0 (cero) si el valor es nulo.
Excepciones: 

• FormatException: si el valor no consta de un signo opcional seguido de una secuencia de dígitos (0 a 9).
• OverflowException: si el valor representa un número menor que MinValue o mayor que MaxValue .

Los siguientes programas ilustran el uso del método Convert.ToUInt16(String, IFormatProvider) :
Ejemplo 1: 

// C# program to demonstrate the
// Convert.ToUInt16() Method
using System;
using System.Globalization;
 
class GFG {
 
// Main Method
public static void Main()
{
    try {
 
        // creating object of CultureInfo
        CultureInfo cultures = new CultureInfo("en-US");
 
        // declaring and initializing String array
        string[] values = {"12345", "+3456",
                                    "3456"};
 
        // calling get() Method
        Console.Write("Converted ushort value"
              + " from a specified string ");
 
        for (int j = 0; j < values.Length; j++)
        {
            get(values[j], cultures);
        }
    }
 
    catch (FormatException e)
    {
        Console.WriteLine("\n");
        Console.Write("Exception Thrown: ");
        Console.Write("{0}", e.GetType(), e.Message);
    }
 
    catch (OverflowException e)
    {
        Console.WriteLine("\n");
        Console.Write("Exception Thrown: ");
        Console.Write("{0}", e.GetType(), e.Message);
    }
}
 
// Defining get() method
public static void get(string s,
           CultureInfo cultures)
{
 
    // converting string to specified ushort
    ushort val = Convert.ToUInt16(s, cultures);
 
    // display the converted ushort value
    Console.Write(" {0}, ", val);
}
}

Converted ushort value from a specified string  12345,  3456,  3456, 

Ejemplo 2: para FormatException

// C# program to demonstrate the
// Convert.ToUInt16() Method
using System;
using System.Globalization;
 
class GFG {
 
// Main Method
public static void Main()
{
    try {
 
        // creating object of CultureInfo
        CultureInfo cultures = new CultureInfo("en-US");
 
        // declaring and initializing
        // String array
        string[] values = {"12345", "+3456",
                                    "3456"};
 
        // calling get() Method
        Console.Write("Converted ushort value"
                 + " of specified strings: ");
 
        for (int j = 0; j < values.Length; j++)
        {
            get(values[j], cultures);
        }
 
        Console.WriteLine("\n");
        string s = "123 456, 789";
 
        Console.WriteLine("format of s is invalid ");
 
        // converting string to specified ushort
        ushort val = Convert.ToUInt16(s, cultures);
 
        // display the converted ushort value
        Console.Write(" {0}, ", val);
    }
 
    catch (FormatException e)
    {
        Console.Write("Exception Thrown: ");
        Console.Write("{0}", e.GetType(), e.Message);
    }
 
    catch (OverflowException e)
    {
        Console.Write("Exception Thrown: ");
        Console.Write("{0}", e.GetType(), e.Message);
    }
}
 
// Defining get() method
public static void get(string s,
           CultureInfo cultures)
{
 
    // converting string to
    // specified ushort value
    ushort val = Convert.ToUInt16(s, cultures);
 
    // display the converted
    // ushort value
    Console.Write(" {0}, ", val);
}
}

Converted ushort value of specified strings:  12345,  3456,  3456, 

format of s is invalid 
Exception Thrown: System.FormatException

Ejemplo 3: para OverflowException

// C# program to demonstrate the
// Convert.ToUInt16 Method
using System;
using System.Globalization;
 
class GFG {
 
// Main Method
public static void Main()
{
 
    try {
 
        // creating object of CultureInfo
        CultureInfo cultures = new CultureInfo("en-US");
 
        // declaring and initializing String array
        string[] values = {"12345", "+3456",
                                    "3456"};
 
        // calling get() Method
        Console.Write("Converted ushort value "
                    + "of specified strings: ");
 
        for (int j = 0; j < values.Length; j++)
        {
            get(values[j], cultures);
        }
 
        Console.WriteLine("\n");
        string s = "-7922816251426433759354395033500000";
 
        Console.WriteLine("s is less than the MinValue");
 
        // converting string to specified ushort
        ushort val = Convert.ToUInt16(s, cultures);
 
        // display the converted ushort value
        Console.WriteLine(" {0}, ", val);
    }
 
    catch (FormatException e)
    {
        Console.Write("Exception Thrown: ");
        Console.Write("{0}", e.GetType(), e.Message);
    }
 
    catch (OverflowException e)
    {
        Console.Write("Exception Thrown: ");
        Console.Write("{0}", e.GetType(), e.Message);
    }
}
 
// Defining get() method
public static void get(string s,
           CultureInfo cultures)
{
 
    // converting string to
    // specified ushort value
    ushort val = Convert.ToUInt16(s, cultures);
 
    // display the converted ushort value
    Console.Write(" {0}, ", val);
}
}

Converted ushort value of specified strings:  12345,  3456,  3456, 

s is less than the MinValue
Exception Thrown: System.OverflowException

Referencia: 

• https://docs.microsoft.com/en-us/dotnet/api/system.convert.touint16?view=netframework-4.7.2#System_Convert_ToUInt16_System_String_System_IFormatProvider_