UInt64.TryParse 方法

参考

定义

命名空间:: System

程序集:: System.Runtime.dll

程序集:: netstandard.dll

程序集:: mscorlib.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

尝试将数字的字符串表示形式转换为等效的 64 位无符号整数。一个指示转换是否成功的返回值。

重载

TryParse(ReadOnlySpan<Byte>, IFormatProvider, UInt64)	尝试将 UTF-8 字符范围解析为值。
TryParse(ReadOnlySpan<Char>, UInt64)	尝试将数字的范围表示形式转换为其等效的 64 位无符号整数。一个指示转换是否成功的返回值。
TryParse(String, UInt64)	尝试将数字的字符串表示形式转换为等效的 64 位无符号整数。一个指示转换是否成功的返回值。
TryParse(ReadOnlySpan<Char>, IFormatProvider, UInt64)	尝试将字符范围解析为值。
TryParse(String, IFormatProvider, UInt64)	尝试将字符串分析为值。
TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, UInt64)	尝试将 UTF-8 字符范围解析为值。
TryParse(ReadOnlySpan<Byte>, UInt64)	尝试将包含数字字符串表示形式的 UTF-8 字符范围转换为其等效的 64 位无符号整数。
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, UInt64)	尝试将指定样式和区域性特定格式的数字的范围表示形式转换为其等效的 64 位无符号整数。一个指示转换是否成功的返回值。
TryParse(String, NumberStyles, IFormatProvider, UInt64)	尝试将数字的指定样式和区域性特定格式的字符串表示形式转换为其等效的 64 位无符号整数。一个指示转换是否成功的返回值。

TryParse(ReadOnlySpan<Byte>, IFormatProvider, UInt64)

尝试将 UTF-8 字符范围解析为值。

public:
 static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt64 % result) = IUtf8SpanParsable<System::UInt64>::TryParse;

public static bool TryParse (ReadOnlySpan<byte> utf8Text, IFormatProvider? provider, out ulong result);

static member TryParse : ReadOnlySpan<byte> * IFormatProvider * uint64 -> bool

Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), provider As IFormatProvider, ByRef result As ULong) As Boolean

参数

utf8Text: ReadOnlySpan<Byte>

要分析的 UTF-8 字符范围。

provider: IFormatProvider

一个对象，提供有关 utf8Text 的区域性特定格式设置信息。

result: UInt64

返回时，包含成功分析 utf8Text 的结果或失败时未定义的值。

Boolean

true 如果 utf8Text 已成功分析，则为 ;否则为 false。

适用于

TryParse(ReadOnlySpan<Char>, UInt64)

重要

此 API 不符合 CLS。

尝试将数字的范围表示形式转换为其等效的 64 位无符号整数。一个指示转换是否成功的返回值。

public:
 static bool TryParse(ReadOnlySpan<char> s, [Runtime::InteropServices::Out] System::UInt64 % result);

public static bool TryParse (ReadOnlySpan<char> s, out ulong result);

[System.CLSCompliant(false)]
public static bool TryParse (ReadOnlySpan<char> s, out ulong result);

static member TryParse : ReadOnlySpan<char> * uint64 -> bool

[<System.CLSCompliant(false)>]
static member TryParse : ReadOnlySpan<char> * uint64 -> bool

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As ULong) As Boolean

参数

s: ReadOnlySpan<Char>

一个范围，包含表示要转换的数字的字符。

result: UInt64

当此方法返回时，如果转换成功，则包含与 s 中所含数字等效的 64 位无符号整数值；如果转换失败，则包含零。如果参数为 null 或 Empty，格式不正确，或表示小于 UInt64.MinValue 或大于 UInt64.MaxValue 的数字，则转换失败。s 此参数未经初始化即进行传递；最初在 result 中提供的任何值都会被覆盖。

Boolean

如果 true 成功转换，则为 s；否则为 false。

属性: CLSCompliantAttribute

适用于

TryParse(String, UInt64)

重要

此 API 不符合 CLS。

符合 CLS 的替代方案: System.Decimal.Parse(String)

尝试将数字的字符串表示形式转换为等效的 64 位无符号整数。一个指示转换是否成功的返回值。

public:
 static bool TryParse(System::String ^ s, [Runtime::InteropServices::Out] System::UInt64 % result);

[System.CLSCompliant(false)]
public static bool TryParse (string s, out ulong result);

public static bool TryParse (string? s, out ulong result);

[System.CLSCompliant(false)]
public static bool TryParse (string? s, out ulong result);

[<System.CLSCompliant(false)>]
static member TryParse : string * uint64 -> bool

static member TryParse : string * uint64 -> bool

Public Shared Function TryParse (s As String, ByRef result As ULong) As Boolean

参数

s: String

表示要转换的数字的字符串。

result: UInt64

Boolean

如果 true 成功转换，则为 s；否则为 false。

属性: CLSCompliantAttribute

示例

下面的示例为字符串数组中的每个元素调用 TryParse(String, UInt64) 一次方法。

string[] numericStrings = { "1293.8", "+1671.7", "28347.", 
                            "   33113684  ", "(0)", "-0", "+1293617", 
                            "18-", "119870", "31,024", "  3127094 ",  
                            "00700000" };
ulong number;
foreach (string numericString in numericStrings)
{
   if (UInt64.TryParse(numericString, out number)) 
      Console.WriteLine("Converted '{0}' to {1}.", numericString, number);
   else
      Console.WriteLine("Cannot convert '{0}' to a UInt64.", numericString);
}
// The example displays the following output:
//       Cannot convert '1293.8' to a UInt64.
//       Cannot convert '+1671.7' to a UInt64.
//       Cannot convert '28347.' to a UInt64.
//       Converted '   33113684  ' to 33113684.
//       Cannot convert '(0)' to a UInt64.
//       Converted '-0' to 0.
//       Converted '+1293617' to 1293617.
//       Cannot convert '18-' to a UInt64.
//       Converted '119870' to 119870.
//       Cannot convert '31,024' to a UInt64.
//       Converted '  3127094 ' to 3127094.
//       Converted '0070000' to 70000.

open System

let numericStrings = 
    [| "1293.8"; "+1671.7"; "28347."
       "   33113684  "; "(0)"; "-0"; "+1293617" 
       "18-"; "119870"; "31,024"; "  3127094 "  
       "00700000" |]
for numericString in numericStrings do
    match UInt64.TryParse numericString with
    | true, number ->
        printfn $"Converted '{numericString}' to {number}."
    | _ ->
        printfn $"Cannot convert '{numericString}' to a UInt64."
// The example displays the following output:
//       Cannot convert '1293.8' to a UInt64.
//       Cannot convert '+1671.7' to a UInt64.
//       Cannot convert '28347.' to a UInt64.
//       Converted '   33113684  ' to 33113684.
//       Cannot convert '(0)' to a UInt64.
//       Converted '-0' to 0.
//       Converted '+1293617' to 1293617.
//       Cannot convert '18-' to a UInt64.
//       Converted '119870' to 119870.
//       Cannot convert '31,024' to a UInt64.
//       Converted '  3127094 ' to 3127094.
//       Converted '0070000' to 70000.

Dim numericStrings() As String = {"1293.8", "+1671.7", "28347.", _
                                  "   33113684  ", "(0)", "-0", "+1293617", _
                                  "18-", "119870", "31,024", "  3127094 ", _ 
                                  "0070000" }
Dim number As ULong
For Each numericString As String In numericStrings
   If UInt64.TryParse(numericString, number) Then
      Console.WriteLine("Converted '{0}' to {1}.", numericString, number)
   Else
      Console.WriteLine("Cannot convert '{0}' to a UInt64.", numericString)
   End If      
Next
' The example displays the following output:
'       Cannot convert '1293.8' to a UInt64.
'       Cannot convert '+1671.7' to a UInt64.
'       Cannot convert '28347.' to a UInt64.
'       Converted '   33113684  ' to 33113684.
'       Cannot convert '(0)' to a UInt64.
'       Converted '-0' to 0.
'       Converted '+1293617' to 1293617.
'       Cannot convert '18-' to a UInt64.
'       Converted '119870' to 119870.
'       Cannot convert '31,024' to a UInt64.
'       Converted '  3127094 ' to 3127094.
'       Converted '0070000' to 70000.

注解

方法 TryParse(String, UInt64) 与方法类似 Parse(String) ，只是在转换失败时不会引发异常。如果无效且无法成功分析，FormatExceptions则此方法无需使用异常处理来测试。

参数 s 应为采用以下格式的十进制数的字符串表示形式：

[ws][sign]digits[ws]

方括号 ([ and ]) 中的元素是可选的。下表对每个元素进行了描述。

元素	说明
ws	可选空格。
sign	可选符号。有效的符号字符由 NumberFormatInfo.NegativeSign 当前区域性的和 NumberFormatInfo.PositiveSign 属性确定。
位数	范围从 0 到 9 的十进制数字序列。

参数 s 通过使用 NumberStyles.Integer 样式进行解释。除了十进制数字之外，只允许使用带前导符号的空格和尾随空格。若要使用中存在的 s区域性特定格式设置信息显式定义样式元素，请 TryParse(String, NumberStyles, IFormatProvider, UInt64) 调用方法。

注意

参数 s 指定的字符串不能包含任何组分隔符或小数分隔符，并且不能包含小数部分。

参数 s 是使用针对当前系统区域性初始化的对象中的 NumberFormatInfo 格式设置信息进行分析的。有关详细信息，请参阅 NumberFormatInfo.CurrentInfo。

此重载将参数中的所有 s 数字解释为十进制数字。若要分析十六进制数的字符串表示形式，请改为调用 TryParse(String, NumberStyles, IFormatProvider, UInt64) 重载。

另请参阅

适用于

TryParse(ReadOnlySpan<Char>, IFormatProvider, UInt64)

尝试将字符范围解析为值。

public:
 static bool TryParse(ReadOnlySpan<char> s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt64 % result) = ISpanParsable<System::UInt64>::TryParse;

public static bool TryParse (ReadOnlySpan<char> s, IFormatProvider? provider, out ulong result);

static member TryParse : ReadOnlySpan<char> * IFormatProvider * uint64 -> bool

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), provider As IFormatProvider, ByRef result As ULong) As Boolean

参数

s: ReadOnlySpan<Char>

要分析的字符范围。

provider: IFormatProvider

一个对象，提供有关 s 的区域性特定格式设置信息。

result: UInt64

此方法返回时，包含成功分析 s的结果或失败时的未定义值。

Boolean

true 如果 s 已成功分析，则为 ;否则为 false。

适用于

TryParse(String, IFormatProvider, UInt64)

尝试将字符串分析为值。

public:
 static bool TryParse(System::String ^ s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt64 % result) = IParsable<System::UInt64>::TryParse;

public static bool TryParse (string? s, IFormatProvider? provider, out ulong result);

static member TryParse : string * IFormatProvider * uint64 -> bool

Public Shared Function TryParse (s As String, provider As IFormatProvider, ByRef result As ULong) As Boolean

参数

s: String

要分析的字符串。

provider: IFormatProvider

一个对象，提供有关 s 的区域性特定格式设置信息。

result: UInt64

此方法返回时，包含成功分析 s 的结果或失败时的未定义值。

Boolean

true 如果 s 已成功分析，则为 ;否则为 false。

适用于

TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, UInt64)

尝试将 UTF-8 字符范围解析为值。

public:
 static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt64 % result) = System::Numerics::INumberBase<System::UInt64>::TryParse;

public static bool TryParse (ReadOnlySpan<byte> utf8Text, System.Globalization.NumberStyles style, IFormatProvider? provider, out ulong result);

static member TryParse : ReadOnlySpan<byte> * System.Globalization.NumberStyles * IFormatProvider * uint64 -> bool

Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), style As NumberStyles, provider As IFormatProvider, ByRef result As ULong) As Boolean

参数

utf8Text: ReadOnlySpan<Byte>

要分析的 UTF-8 字符范围。

style: NumberStyles

可以存在于中的 utf8Text数字样式的按位组合。

provider: IFormatProvider

一个对象，提供有关 utf8Text 的区域性特定格式设置信息。

result: UInt64

返回时，包含成功分析 utf8Text 的结果或失败时未定义的值。

Boolean

true 如果 utf8Text 已成功分析，则为 ;否则为 false。

适用于

TryParse(ReadOnlySpan<Byte>, UInt64)

尝试将包含数字字符串表示形式的 UTF-8 字符范围转换为其等效的 64 位无符号整数。

public:
 static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, [Runtime::InteropServices::Out] System::UInt64 % result);

public static bool TryParse (ReadOnlySpan<byte> utf8Text, out ulong result);

static member TryParse : ReadOnlySpan<byte> * uint64 -> bool

Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), ByRef result As ULong) As Boolean

参数

utf8Text: ReadOnlySpan<Byte>

包含表示要转换的数字的 UTF-8 字符的跨度。

result: UInt64

此方法返回时，如果转换成功，则包含与中包含的 utf8Text 数字等效的 64 位无符号整数值;如果转换失败，则包含零。此参数未经初始化即进行传递；最初在 result 中提供的任何值都会被覆盖。

Boolean

如果 true 成功转换，则为 utf8Text；否则为 false。

适用于

TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, UInt64)

重要

此 API 不符合 CLS。

尝试将指定样式和区域性特定格式的数字的范围表示形式转换为其等效的 64 位无符号整数。一个指示转换是否成功的返回值。

public:
 static bool TryParse(ReadOnlySpan<char> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt64 % result);

public:
 static bool TryParse(ReadOnlySpan<char> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt64 % result) = System::Numerics::INumberBase<System::UInt64>::TryParse;

public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider? provider, out ulong result);

[System.CLSCompliant(false)]
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider provider, out ulong result);

[System.CLSCompliant(false)]
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider? provider, out ulong result);

static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * uint64 -> bool

[<System.CLSCompliant(false)>]
static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * uint64 -> bool

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), style As NumberStyles, provider As IFormatProvider, ByRef result As ULong) As Boolean

参数

s: ReadOnlySpan<Char>

一个范围，包含表示要转换的数字的字符。该范围使用由 style 参数指定的样式来进行解释。

style: NumberStyles

枚举值的一个按位组合，指示 s 所允许的格式。要指定的一个典型值为 Integer。

provider: IFormatProvider

一个对象，提供有关 s 的区域性特定格式设置信息。

result: UInt64

当此方法返回时，如果转换成功，则包含与 s 中所含数字等效的 64 位无符号整数值；如果转换失败，则包含零。如果参数为 null 或 Empty，格式不符合 style，或者表示小于 UInt64.MinValue 或大于 UInt64.MaxValue 的数字，则转换失败。s 此参数未经初始化即进行传递；最初在 result 中提供的任何值都会被覆盖。

Boolean

如果 true 成功转换，则为 s；否则为 false。

属性: CLSCompliantAttribute

适用于

TryParse(String, NumberStyles, IFormatProvider, UInt64)

重要

此 API 不符合 CLS。

符合 CLS 的替代方案: System.Decimal.Parse(String)

尝试将数字的指定样式和区域性特定格式的字符串表示形式转换为其等效的 64 位无符号整数。一个指示转换是否成功的返回值。

public:
 static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt64 % result);

public:
 static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt64 % result) = System::Numerics::INumberBase<System::UInt64>::TryParse;

[System.CLSCompliant(false)]
public static bool TryParse (string s, System.Globalization.NumberStyles style, IFormatProvider provider, out ulong result);

public static bool TryParse (string? s, System.Globalization.NumberStyles style, IFormatProvider? provider, out ulong result);

[System.CLSCompliant(false)]
public static bool TryParse (string? s, System.Globalization.NumberStyles style, IFormatProvider? provider, out ulong result);

[<System.CLSCompliant(false)>]
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * uint64 -> bool

static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * uint64 -> bool

Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As ULong) As Boolean

参数

s: String

表示要转换的数字的字符串。该字符串使用由 style 参数指定的样式来进行解释。

style: NumberStyles

枚举值的一个按位组合，指示 s 所允许的格式。要指定的一个典型值为 Integer。

provider: IFormatProvider

一个对象，提供有关 s 的区域性特定格式设置信息。

result: UInt64

Boolean

如果 true 成功转换，则为 s；否则为 false。

属性: CLSCompliantAttribute

例外

ArgumentException

style 不是 NumberStyles 值。

- 或 -

style 不是 AllowHexSpecifier 和 HexNumber 值的组合。

示例

以下示例使用许多不同的字符串和NumberStyles值调用 TryParse(String, NumberStyles, IFormatProvider, UInt64) 方法。

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string numericString;
      NumberStyles styles;
      
      numericString = "2106034";
      styles = NumberStyles.Integer;
      CallTryParse(numericString, styles);
      
      numericString = "-10603";
      styles = NumberStyles.None;
      CallTryParse(numericString, styles);
      
      numericString = "29103674.00";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);
      
      numericString = "10345.72";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);

      numericString = "41792210E-01";
      styles = NumberStyles.Integer | NumberStyles.AllowExponent;
      CallTryParse(numericString, styles); 
      
      numericString = "9112E-01";
      CallTryParse(numericString, styles);
          
      numericString = "312E01";
      CallTryParse(numericString, styles); 
      
      numericString = "FFC86DA1";
      CallTryParse(numericString, NumberStyles.HexNumber);
      
      numericString = "0x8F8C";
      CallTryParse(numericString, NumberStyles.HexNumber);
   }
   
   private static void CallTryParse(string stringToConvert, NumberStyles styles)
   {
      ulong number;
      bool result = UInt64.TryParse(stringToConvert, styles, 
                                   CultureInfo.InvariantCulture, out number);
      if (result)
         Console.WriteLine($"Converted '{stringToConvert}' to {number}.");
      else
         Console.WriteLine($"Attempted conversion of '{stringToConvert}' failed.");
   }
}
// The example displays the following output:
//       Converted '2106034' to 2106034.
//       Attempted conversion of '-10603' failed.
//       Converted '29103674.00' to 29103674.
//       Attempted conversion of '10345.72' failed.
//       Converted '41792210E-01' to 4179221.
//       Attempted conversion of '9112E-01' failed.
//       Converted '312E01' to 3120.
//       Converted 'FFC86DA1' to 4291325345.
//       Attempted conversion of '0x8F8C' failed.

open System
open System.Globalization

let callTryParse (stringToConvert: string) (styles: NumberStyles) =
    match UInt64.TryParse(stringToConvert, styles, CultureInfo.InvariantCulture) with
    | true, number ->
        printfn $"Converted '{stringToConvert}' to {number}."
    | _ ->
        printfn $"Attempted conversion of '{stringToConvert}' failed."

do
    let numericString = "2106034"
    let styles = NumberStyles.Integer
    callTryParse numericString styles
    
    let numericString = "-10603"
    let styles = NumberStyles.None
    callTryParse numericString styles
    
    let numericString = "29103674.00"
    let styles = NumberStyles.Integer ||| NumberStyles.AllowDecimalPoint
    callTryParse numericString styles
    
    let numericString = "10345.72"
    let styles = NumberStyles.Integer ||| NumberStyles.AllowDecimalPoint
    callTryParse numericString styles

    let numericString = "41792210E-01"
    let styles = NumberStyles.Integer ||| NumberStyles.AllowExponent
    callTryParse numericString styles
    
    let numericString = "9112E-01"
    callTryParse numericString styles
        
    let numericString = "312E01"
    callTryParse numericString styles
    
    let numericString = "FFC86DA1"
    callTryParse numericString NumberStyles.HexNumber
    
    let numericString = "0x8F8C"
    callTryParse numericString NumberStyles.HexNumber
// The example displays the following output:
//       Converted '2106034' to 2106034.
//       Attempted conversion of '-10603' failed.
//       Converted '29103674.00' to 29103674.
//       Attempted conversion of '10345.72' failed.
//       Converted '41792210E-01' to 4179221.
//       Attempted conversion of '9112E-01' failed.
//       Converted '312E01' to 3120.
//       Converted 'FFC86DA1' to 4291325345.
//       Attempted conversion of '0x8F8C' failed.

Imports System.Globalization

Module Example
   Public Sub Main()
      Dim numericString As String
      Dim styles As NumberStyles
      
      numericString = "2106034"
      styles = NumberStyles.Integer
      CallTryParse(numericString, styles)
      
      numericString = "-10603"
      styles = NumberStyles.None
      CallTryParse(numericString, styles)
      
      numericString = "29103674.00"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)
      
      numericString = "10345.72"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)

      numericString = "41792210E-01"
      styles = NumberStyles.Integer Or NumberStyles.AllowExponent
      CallTryParse(numericString, styles) 
      
      numericString = "9112E-01"
      CallTryParse(numericString, styles)
          
      numericString = "312E01"
      CallTryParse(numericString, styles) 
      
      numericString = "FFC86DA1"
      CallTryParse(numericString, NumberStyles.HexNumber)
      
      numericString = "0x8F8C"
      CallTryParse(numericString, NumberStyles.HexNumber)
   End Sub
   
   Private Sub CallTryParse(stringToConvert As String, styles AS NumberStyles)
      Dim number As ULong
      Dim result As Boolean = UInt64.TryParse(stringToConvert, styles, _
                                              CultureInfo.InvariantCulture, number)
      If result Then
         Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number)
      Else
         Console.WriteLine("Attempted conversion of '{0}' failed.", _
                           Convert.ToString(stringToConvert))
      End If                                                                           
   End Sub
End Module
' The example displays the following output to the console:
'       Converted '2106034' to 2106034.
'       Attempted conversion of '-10603' failed.
'       Converted '29103674.00' to 29103674.
'       Attempted conversion of '10345.72' failed.
'       Converted '41792210E-01' to 4179221.
'       Attempted conversion of '9112E-01' failed.
'       Converted '312E01' to 3120.
'       Converted 'FFC86DA1' to 4291325345.
'       Attempted conversion of '0x8F8C' failed.

注解

方法 TryParse(String, NumberStyles, IFormatProvider, UInt64) 类似于 Parse(String, NumberStyles, IFormatProvider) 方法，只是在转换失败时不会引发异常。此方法无需使用异常处理来测试 FormatException 是否 s 无效且无法成功分析。

参数 style 定义 (样式元素，例如空格或正或负号) ，这些元素在参数中 s 允许分析操作成功。它必须是枚举中的位标志 NumberStyles 的组合。根据的值 style， s 参数可能包含以下元素：

[ws][$][sign][digits，]digits[.fractional_digits][E[sign]exponential_digits][ws]

方括号中的项 ([ 和 ]) 是可选的。或者，如果 style 参数包含 NumberStyles.AllowHexSpecifier，则 s 参数可以包含以下元素：

[ws]hexdigits[ws]

下表对每个元素进行了描述。

元素	说明
ws	可选空格。如果包含标志，`s`则开头会显示空格，如果`stylestyle`包含 NumberStyles.AllowLeadingWhite NumberStyles.AllowTrailingWhite 标志，则空格会显示在末尾`s`。
$	区域性特定的货币符号。它在字符串中的位置由 CurrencyPositivePattern 参数的方法`provider`返回GetFormat的 NumberFormatInfo 对象的属性定义。如果`style`包含标志，NumberStyles.AllowCurrencySymbol则可以显示`s`货币符号。
sign	可选符号。如果`style`包含标志，则符号可以出现在的`s`开头，如果`style`包含 NumberStyles.AllowTrailingSign 标志，则它可以显示在 `s`NumberStyles.AllowLeadingSign 末尾。如果`style`包含 NumberStyles.AllowParentheses 标志，则可以在中使用`s`括号来指示负值。但是，如果存在负号， `s` 则只能表示分析操作成功的值零。
位数	从 0 到 9 的数字序列。
,	区域性特定的组分隔符。如果包含标志，则指定的`provider`区域性的组分隔符会显示在中`s`。NumberStyles.AllowThousands`style`
.	区域性特定的小数点符号。如果包含标志，则指定的`provider`区域性的小数点符号可能会出现在中`s`。NumberStyles.AllowDecimalPoint`style`
fractional_digits	数字 0 的一个或多个匹配项。仅当包含 NumberStyles.AllowDecimalPoint 标志时`style`，小数位数才能显示在中`s`。
E	“e”或“E”字符，指示值以指数 (科学) 表示法表示。如果`style`包含标志，参数`s`可以表示指数表示法的数字NumberStyles.AllowExponent。
exponential_digits	从 0 到 9 的数字序列。如果`style`包含标志，参数`s`可以表示指数表示法的数字NumberStyles.AllowExponent。
hexdigits	从 0 到 f 或 0 到 F 的十六进制数字序列。

注意

分析操作将忽略中 s 任何 (U+0000) 字符的终止 NUL，而不考虑参数的值 style 。

仅包含十进制数字的字符串 (对应于 NumberStyles.None 标志) 始终成功分析。此输入字符串中可能存在但不一定存在的大多数剩余 NumberStyles 成员控制元素。下表指示各个 NumberStyles 成员如何影响中可能存在的 s元素。

非复合 `NumberStyles` 值	除数字外的值允许的元素
None	仅十进制数字。
AllowDecimalPoint	小数点 (.) 和 fractional_digits 元素。但是， fractional_digits 只能包含一个或多个 0 位，否则方法将 `false`返回。
AllowExponent	指示指数表示法的“e”或“E”字符以及 exponential_digits。如果 `s` 以指数表示法表示数字，则它不能具有非零的小数分量。
AllowLeadingWhite	开头的 `s`ws 元素。
AllowTrailingWhite	末尾的 `s`ws 元素。
AllowLeadingSign	数字前的符号元素。
AllowTrailingSign	数字后面的符号元素。
AllowParentheses	带零个数值的括号形式的符号元素。
AllowThousands	组分隔符 (、) 元素。
AllowCurrencySymbol	货币 ($) 元素。
Currency	所有元素。但是， `s` 不能表示十六进制数或指数表示法中的数字。
Float	开头或结尾处的 `s`ws 元素，符号位于的开头`s`，小数点 (。) 符号。参数 `s` 还可以使用指数表示法。
Number	ws、符号、组分隔符 (、) 和小数点 (.) 元素。
Any	所有元素。但是， `s` 不能表示十六进制数。

如果使用标志 NumberStyles.AllowHexSpecifier ， s 则必须是十六进制值。有效的十六进制字符为 0-9、A-F 和 a-f。不支持“0x”等前缀，导致分析操作失败。中唯一可以存在的 style 其他标志是 NumberStyles.AllowLeadingWhite 和 NumberStyles.AllowTrailingWhite。 (枚举 NumberStyles 具有复合样式， HexNumber包括空格标志。)

注意

如果 s 是十六进制数的字符串表示形式，则它前面不能有任何修饰 (（如 0x 或 &h) ）将其区分为十六进制数。这会导致转换失败。

参数 provider 是实现 IFormatProvider 。其 GetFormat 方法返回一个 NumberFormatInfo 对象，该对象提供有关格式的 s区域性特定信息。参数 provider 可以是以下任一参数：

一个 CultureInfo 对象，该对象表示提供格式设置信息的区域性。其 GetFormat 方法返回对象， NumberFormatInfo 该对象为该区域性提供数值格式设置信息。
提供 NumberFormatInfo 数值格式设置信息的对象。 (它的实现 GetFormat 只是返回自身。)
实现的 IFormatProvider自定义对象。其 GetFormat 方法实例化并返回 NumberFormatInfo 提供格式设置信息的对象。

如果 provider 为 null，则 NumberFormatInfo 使用当前区域性的对象。

另请参阅

适用于

UInt64.TryParse 方法

定义

重载

TryParse(ReadOnlySpan<Byte>, IFormatProvider, UInt64)

参数

返回

适用于

TryParse(ReadOnlySpan<Char>, UInt64)

参数

返回

适用于

TryParse(String, UInt64)

参数

返回

示例

注解

另请参阅

适用于

TryParse(ReadOnlySpan<Char>, IFormatProvider, UInt64)

参数

返回

适用于

TryParse(String, IFormatProvider, UInt64)

参数

返回

适用于

TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, UInt64)

参数

返回

适用于

TryParse(ReadOnlySpan<Byte>, UInt64)

参数

返回

适用于

TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, UInt64)

参数

返回

适用于

TryParse(String, NumberStyles, IFormatProvider, UInt64)

参数

返回

例外

示例

注解

另请参阅

适用于

反馈

其他资源