此方法用于使用指定的区域性特定格式信息将数字的指定字符串表示形式转换为等效的64位无符号整数。
句法:
public static ulong ToUInt64 (string value, IFormatProvider provider);
参数:
- value:它是一个包含要转换的数字的字符串。
- provider:提供者:提供特定于区域性的格式信息的对象。
返回值:该方法返回一个64位无符号整数,该整数等于value中的数字,如果value为null,则返回0(零)。
例外情况:
- FormatException:如果该值不包含一个可选的符号,后跟一个数字序列(0到9)。
- OverflowException:如果该值表示一个小于MinValue或大于MaxValue的数字。
下面的程序说明了Convert.ToUInt64(String,IFormatProvider)方法的用法:
范例1:
// C# program to demonstrate the
// Convert.ToUInt64() 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 = {"123456789012",
"+123456789012",
"18446744073709551615"};
// calling get() Method
Console.WriteLine("Converted ulong 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 ulong
ulong val = Convert.ToUInt64(s, cultures);
// display the converted ulong value
Console.Write(" {0}, ", val);
}
}
输出:
Converted ulong value from a specified string
123456789012, 123456789012, 18446744073709551615,
示例2:对于FormatException
// C# program to demonstrate the
// Convert.ToUInt64() 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 = {"123456789012",
"+123456789012",
"18446744073709551615"};
// calling get() Method
Console.WriteLine("Converted ulong 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 ulong
long val = Convert.ToInt64(s, cultures);
// display the converted ulong 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 ulong value
ulong val = Convert.ToUInt64(s,
cultures);
// display the converted
// ulong value
Console.Write(" {0}, ", val);
}
}
输出:
Converted ulong value of specified strings:
123456789012, 123456789012, 18446744073709551615,
format of s is invalid
Exception Thrown: System.FormatException
示例3:对于OverflowException
// C# program to demonstrate the
// Convert.ToUInt64() 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 = {"123456789012",
"+123456789012",
"18446744073709551615"};
// calling get() Method
Console.WriteLine("Converted ulong 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 ulong
ulong val = Convert.ToUInt64(s, cultures);
// display the converted ulong 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 ulong value
ulong val = Convert.ToUInt64(s, cultures);
// display the converted ulong value
Console.Write(" {0}, ", val);
}
}
输出:
Converted ulong value of specified strings:
123456789012, 123456789012, 18446744073709551615,
s is less than the MinValue
Exception Thrown: System.OverflowException
参考:
- https://docs.microsoft.com/zh-cn/dotnet/api/system.convert.touint64?view=netframework-4.7.2#System_Convert_ToUInt64_System_String_System_IFormatProvider_