此方法用于使用指定的区域性特定格式信息将数字的指定字符串表示形式转换为等效的16位无符号整数。
句法:
public static ushort ToUInt16 (string value, IFormatProvider provider);
参数:
- value:它是一个包含要转换的数字的字符串。
- provider:提供者:提供特定于区域性的格式信息的对象。
返回值:此方法返回一个16位无符号整数,该整数等于value中的数字;如果value为null,则返回0(零)。
例外情况:
- FormatException:如果该值不包含一个可选的符号,后跟一个数字序列(0到9)。
- OverflowException:如果该值表示一个小于MinValue或大于MaxValue的数字。
下面的程序说明了Convert.ToUInt16(String,IFormatProvider)方法的用法:
范例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 sttring ");
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 sttring 12345, 3456, 3456,
示例2:对于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
示例3:对于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
参考:
- https://docs.microsoft.com/zh-cn/dotnet/api/system.convert.touint16?view=netframework-4.7.2#System_Convert_ToUInt16_System_String_System_IFormatProvider_