C# | Convert.ToUInt16(String, IFormatProvider) Method
This method is used to convert the specified string representation of a number to an equivalent 16-bit unsigned integer, using the specified culture-specific formatting information.
Syntax:
public static ushort ToUInt16 (string value, IFormatProvider provider);
Parameters:
- value: It is a string that contains the number to convert.
- provider: It is an object that supplies culture-specific formatting information.
Return Value: This method returns a 16-bit unsigned integer that is equivalent to the number in value, or 0 (zero) if value is null.
Exceptions:
- FormatException: If the value does not consist of an optional sign followed by a sequence of digits (0 through 9).
- OverflowException: If the value represents a number that is less than MinValue or greater than MaxValue.
Below programs illustrate the use of Convert.ToUInt16(String, IFormatProvider) Method:
Example 1:
csharp
// 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); } } |
Output
Converted ushort value from a specified string 12345, 3456, 3456,
Example 2: For FormatException
csharp
// 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); } } |
Output:
Converted ushort value of specified strings: 12345, 3456, 3456, format of s is invalid Exception Thrown: System.FormatException
Example 3: For OverflowException
csharp
// 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); } } |
Output:
Converted ushort value of specified strings: 12345, 3456, 3456, s is less than the MinValue Exception Thrown: System.OverflowException
Reference:
- https://docs.microsoft.com/en-us/dotnet/api/system.convert.touint16?view=netframework-4.7.2#System_Convert_ToUInt16_System_String_System_IFormatProvider_
Contact Us