Double.TryParse 方法

参考

定义

命名空间:: System

程序集:: System.Runtime.dll

程序集:: netstandard.dll

程序集:: mscorlib.dll

重要

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

将数字的字符串表示形式转换为等效的双精度浮点数。返回值指示转换是成功还是失败。

重载

TryParse(String, IFormatProvider, Double)	尝试将字符串分析为值。
TryParse(ReadOnlySpan<Char>, Double)	将指定样式和区域性特定格式的数字的跨度表示形式转换为其等效的双精度浮点数。返回值指示转换是成功还是失败。
TryParse(String, Double)	将数字的字符串表示形式转换为等效的双精度浮点数。返回值指示转换是成功还是失败。
TryParse(ReadOnlySpan<Byte>, IFormatProvider, Double)	尝试将 UTF-8 字符的范围分析为值。
TryParse(ReadOnlySpan<Char>, IFormatProvider, Double)	尝试将字符范围分析为值。
TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, Double)	尝试将 UTF-8 字符的范围分析为值。
TryParse(ReadOnlySpan<Byte>, Double)	尝试将包含数字字符串表示形式的 UTF-8 字符范围转换为其等效的双精度浮点数。
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Double)	将包含指定样式和区域性特定格式的数字的字符串表示形式的字符范围转换为其等效的双精度浮点数。返回值指示转换是成功还是失败。
TryParse(String, NumberStyles, IFormatProvider, Double)	将指定样式和区域性特定格式的数字的字符串表示形式转换为等效的双精度浮点数。返回值指示转换是成功还是失败。

注解

在 .NET Core 3.0 及更高版本中，无法表示的值舍入为 IEEE 754 规范所需的 PositiveInfinity 或 NegativeInfinity。在早期版本中（包括 .NET Framework）中，分析的值太大而无法表示导致失败。

TryParse(String, IFormatProvider, Double)

Source:: Double.cs

Source:: Double.cs

Source:: Double.cs

尝试将字符串分析为值。

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

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

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

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

参数

s: String

要分析的字符串。

provider: IFormatProvider

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

result: Double

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

Boolean

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

适用于

TryParse(ReadOnlySpan<Char>, Double)

Source:: Double.cs

Source:: Double.cs

Source:: Double.cs

将指定样式和区域性特定格式的数字的跨度表示形式转换为其等效的双精度浮点数。返回值指示转换是成功还是失败。

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

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

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

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

参数

s: ReadOnlySpan<Char>

包含要转换的数字的字符串表示形式的字符范围。

result: Double

此方法返回时，如果转换成功，则包含与 s 参数中包含的数值或符号等效的双精度浮点数;如果转换失败，则包含零。如果 s 参数 null 或为空，则转换失败。如果 s 的有效数字小于 Double.MinValue，则 resultNegativeInfinity。如果是大于 double.MaxValue的有效数字，则。此参数未初始化传递;将覆盖最初在 result 中提供的任何值。

Boolean

如果已成功转换 s，则 true;否则，false。

注解

适用于

TryParse(String, Double)

Source:: Double.cs

Source:: Double.cs

Source:: Double.cs

将数字的字符串表示形式转换为等效的双精度浮点数。返回值指示转换是成功还是失败。

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

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

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

static member TryParse : string * double -> bool

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

参数

s: String

包含要转换的数字的字符串。

result: Double

此方法返回时，如果转换成功，则包含与 s 参数等效的双精度浮点数;如果转换失败，则包含零。如果 s 参数 null 或 Empty 或不是有效格式的数字，则转换失败。如果 s 表示小于 Double.MinValue 或大于 double.MaxValue，则它还在 .NET Framework 和 .NET Core 2.2 及更低版本上失败。此参数未初始化传递;将覆盖最初在 result 中提供的任何值。

Boolean

如果已成功转换 s，则 true;否则，false。

示例

以下示例使用 TryParse(String, Double) 方法将数值的字符串表示形式转换为 Double 值。它假定 en-US 是当前区域性。

using System;

public class Example
{
   public static void Main()
   {
      string[] values = { "1,643.57", "$1,643.57", "-1.643e6",
                          "-168934617882109132", "123AE6",
                          null, String.Empty, "ABCDEF" };
      double number;

      foreach (var value in values) {
         if (Double.TryParse(value, out number))
            Console.WriteLine("'{0}' --> {1}", value, number);
         else
            Console.WriteLine("Unable to parse '{0}'.", value);
      }
   }
}
// The example displays the following output:
//       '1,643.57' --> 1643.57
//       Unable to parse '$1,643.57'.
//       '-1.643e6' --> -1643000
//       '-168934617882109132' --> -1.68934617882109E+17
//       Unable to parse '123AE6'.
//       Unable to parse ''.
//       Unable to parse ''.
//       Unable to parse 'ABCDEF'.

open System

let values =
    [| "1,643.57"; "$1,643.57"; "-1.643e6"
       "-168934617882109132"; "123AE6"
       null; String.Empty; "ABCDEF" |]

for value in values do
    match Double.TryParse value with
    | true, number ->
        printfn $"'{value}' --> {number}"
    | _ ->
        printfn $"Unable to parse '{value}'."
// The example displays the following output:
//       '1,643.57' --> 1643.57
//       Unable to parse '$1,643.57'.
//       '-1.643e6' --> -1643000
//       '-168934617882109132' --> -1.68934617882109E+17
//       Unable to parse '123AE6'.
//       Unable to parse ''.
//       Unable to parse ''.
//       Unable to parse 'ABCDEF'.

Module Example
   Public Sub Main()
      Dim values() As String = { "1,643.57", "$1,643.57", "-1.643e6", 
                                "-168934617882109132", "123AE6", 
                                Nothing, String.Empty, "ABCDEF" }
      Dim number As Double
      
      For Each value In values
         If Double.TryParse(value, number) Then
            Console.WriteLine("'{0}' --> {1}", value, number)
         Else
            Console.WriteLine("Unable to parse '{0}'.", value)      
         End If   
      Next   
   End Sub
End Module
' The example displays the following output:
'       '1,643.57' --> 1643.57
'       Unable to parse '$1,643.57'.
'       '-1.643e6' --> -1643000
'       '-168934617882109132' --> -1.68934617882109E+17
'       Unable to parse '123AE6'.
'       Unable to parse ''.
'       Unable to parse ''.
'       Unable to parse 'ABCDEF'.

注解

此重载与 Double.Parse(String) 方法不同，方法是返回一个布尔值，该值指示分析操作是否成功，而不是返回已分析的数值。它消除了在 s 无效且无法成功分析的情况下使用异常处理来测试 FormatException 的需要。

s 参数可以包含当前区域性的 NumberFormatInfo.PositiveInfinitySymbol、NumberFormatInfo.NegativeInfinitySymbol、NumberFormatInfo.NaNSymbol（字符串比较区分大小写）或格式的字符串：

[ws][sign][integral-digits，]integral-digits[.[fractional-digits][e[sign]exponential-digits][ws]

方括号中的元素是可选的。下表描述了每个元素。

元素	描述
ws	一系列空白字符。
签名	负号或正符号。
整型数字	一系列数字字符，范围从 0 到 9，用于指定数字的整部分。如果存在小数位数，则可以缺少整型数字。
、	区域性特定的组分隔符符号。
。	区域性特定的小数点符号。
小数位数	一系列数字字符，范围从 0 到 9，用于指定数字的小数部分。
E	一个大写或小写字符“e”，指示指数（科学）表示法。
指数位数	一系列数字字符，范围从 0 到 9，用于指定指数。

有关数值格式的详细信息，请参阅格式设置类型。

s 参数通过使用 NumberStyles.Float 和 NumberStyles.AllowThousands 标志的组合来解释。这意味着允许空格和数千个分隔符，但货币符号不是。若要显式定义可以存在于 s中的元素（如货币符号、千位分隔符和空格），请使用 Double.TryParse(String, NumberStyles, IFormatProvider, Double) 方法重载。

s 参数是使用为当前系统区域性初始化的 NumberFormatInfo 对象中的格式信息进行分析的。有关详细信息，请参阅 NumberFormatInfo.CurrentInfo。若要使用其他指定区域性的格式设置信息分析字符串，请使用 Double.TryParse(String, NumberStyles, IFormatProvider, Double) 方法重载。

通常，如果将 Double.TryParse 方法传递给通过调用 Double.ToString 方法创建的字符串，则返回原始 Double 值。但是，由于精度损失，值可能不相等。此外，尝试分析 Double.MinValue 或 Double.MaxValue 的字符串表示形式无法往返。在 .NET Framework 和 .NET Core 2.2 及早期版本中，它引发 OverflowException。在 .NET Core 3.0 及更高版本中，如果尝试分析 MinValue 或 Double.PositiveInfinity 尝试分析 MaxValue，则返回 Double.NegativeInfinity。以下示例提供了一个插图。

using System;

public class Example
{
   public static void Main()
   {
      string value;
      double number;

      value = Double.MinValue.ToString();
      if (Double.TryParse(value, out number))
         Console.WriteLine(number);
      else
         Console.WriteLine("{0} is outside the range of a Double.",
                           value);

      value = Double.MaxValue.ToString();
      if (Double.TryParse(value, out number))
         Console.WriteLine(number);
      else
         Console.WriteLine("{0} is outside the range of a Double.",
                           value);
   }
}
// The example displays the following output:
//    -1.79769313486232E+308 is outside the range of the Double type.
//    1.79769313486232E+308 is outside the range of the Double type.

open System

[<EntryPoint>]
let main _ = 
    let value = string Double.MinValue
    match Double.TryParse value with
    | true, number ->
        printfn $"{number}"
    | _ ->
        printfn $"{value} is outside the range of a Double."

    let value = string Double.MaxValue
    match Double.TryParse value with
    | true, number ->
        printfn $"{number}"
    | _ ->
        printfn $"{value} is outside the range of a Double."

    0
// The example displays the following output:
//    -1.79769313486232E+308 is outside the range of the Double type.
//    1.79769313486232E+308 is outside the range of the Double type.

Module Example
   Public Sub Main()
      Dim value As String
      Dim number As Double
      
      value = Double.MinValue.ToString()
      If Double.TryParse(value, number) Then
         Console.WriteLine(number)
      Else
         Console.WriteLine("{0} is outside the range of a Double.", _
                           value)
      End If
      
      value = Double.MaxValue.ToString()
      If Double.TryParse(value, number) Then
         Console.WriteLine(number)
      Else
         Console.WriteLine("{0} is outside the range of a Double.", _
                           value)
      End If
   End Sub
End Module
' The example displays the following output:
'    -1.79769313486232E+308 is outside the range of the Double type.
'    1.79769313486232E+308 is outside the range of the Double type.

在 .NET Framework 和 .NET Core 2.2 及更早版本中，如果 s 与 Double 数据类型的范围不同，TryParse(String, Double) 方法将引发 OverflowException。

在 .NET Core 3.0 及更高版本中，当 s 超过 Double 数据类型的范围时，不会引发异常。在大多数情况下，TryParse(String, Double) 方法计算 Double.PositiveInfinity 或 Double.NegativeInfinity的结果。但是，有一小组值被认为更接近 Double 的最大值或最小值，而不是正或负无穷大。在这些情况下，该方法计算 Double.MaxValue 或 Double.MinValue的结果。

如果在分析操作期间 s 参数中遇到分隔符，并且小数和组分隔符相同，则分析操作假定分隔符是小数分隔符，而不是组分隔符。有关分隔符的详细信息，请参阅 CurrencyDecimalSeparator、NumberDecimalSeparator、CurrencyGroupSeparator和 NumberGroupSeparator。

另请参阅

Parse(String)
ToString()
分析 .NET 中的数值字符串
示例：.NET Core WinForms 格式设置实用工具（C#）
示例：.NET Core WinForms 格式设置实用工具（Visual Basic）

适用于

TryParse(ReadOnlySpan<Byte>, IFormatProvider, Double)

Source:: Double.cs

Source:: Double.cs

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

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

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

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

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

参数

utf8Text: ReadOnlySpan<Byte>

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

provider: IFormatProvider

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

result: Double

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

Boolean

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

适用于

TryParse(ReadOnlySpan<Char>, IFormatProvider, Double)

Source:: Double.cs

Source:: Double.cs

Source:: Double.cs

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

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

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

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

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

参数

s: ReadOnlySpan<Char>

要分析的字符范围。

provider: IFormatProvider

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

result: Double

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

Boolean

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

适用于

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

Source:: Double.cs

Source:: Double.cs

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

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

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

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

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

参数

utf8Text: ReadOnlySpan<Byte>

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

style: NumberStyles

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

provider: IFormatProvider

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

result: Double

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

Boolean

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

适用于

TryParse(ReadOnlySpan<Byte>, Double)

Source:: Double.cs

Source:: Double.cs

尝试将包含数字字符串表示形式的 UTF-8 字符范围转换为其等效的双精度浮点数。

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

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

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

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

参数

utf8Text: ReadOnlySpan<Byte>

包含要转换的数字的只读 UTF-8 字符范围。

result: Double

此方法返回时，如果转换成功或转换失败，则包含与 utf8Text 中包含的数值或符号等效的双精度浮点数。如果 utf8TextEmpty 或格式无效，则转换失败。此参数未初始化传递;将覆盖最初在结果中提供的任何值。

Boolean

如果已成功转换 utf8Text，则 true;否则，false。

适用于

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

Source:: Double.cs

Source:: Double.cs

Source:: Double.cs

将包含指定样式和区域性特定格式的数字的字符串表示形式的字符范围转换为其等效的双精度浮点数。返回值指示转换是成功还是失败。

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

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

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

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

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

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

参数

s: ReadOnlySpan<Char>

包含要转换的数字的只读字符范围。

style: NumberStyles

指示允许 s格式的 NumberStyles 值的按位组合。要指定的典型值 Float 与 AllowThousands结合使用。

provider: IFormatProvider

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

result: Double

此方法返回并且转换成功时，包含与 s中包含的数值或符号等效的双精度浮点数。如果转换失败，则包含零。如果 s 参数为 null、空字符范围或不符合 style格式的数字，则转换失败。如果 s 的有效数字小于 Double.MinValue，则 resultNegativeInfinity。如果是大于 double.MaxValue的有效数字，则。此参数未初始化传递;将覆盖最初在 result 中提供的任何值。

Boolean

如果已成功转换 s，则 true;否则，false。

注解

适用于

TryParse(String, NumberStyles, IFormatProvider, Double)

Source:: Double.cs

Source:: Double.cs

Source:: Double.cs

将指定样式和区域性特定格式的数字的字符串表示形式转换为等效的双精度浮点数。返回值指示转换是成功还是失败。

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

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

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

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

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

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

参数

s: String

包含要转换的数字的字符串。

style: NumberStyles

指示允许 s格式的 NumberStyles 值的按位组合。要指定的典型值 Float 与 AllowThousands结合使用。

provider: IFormatProvider

提供有关 s的区域性特定格式设置信息的 IFormatProvider。

result: Double

此方法返回时，如果转换成功，则包含与 s中包含的数值或符号等效的双精度浮点数;如果转换失败，则包含零。如果 s 参数 null 或 Empty 或格式不符合 style，或者 style 不是 NumberStyles 枚举常量的有效组合，则转换失败。如果 s 表示小于 SByte.MinValue 或大于 SByte.MaxValue，则它还在 .NET Framework 或 .NET Core 2.2 及更低版本上失败。此参数未初始化传递;将覆盖最初在 result 中提供的任何值。

Boolean

如果已成功转换 s，则 true;否则，false。

例外

ArgumentException

style 不是 NumberStyles 值。

-或-

style 包括 AllowHexSpecifier 值。

示例

以下示例演示如何使用 Double.TryParse(String, NumberStyles, IFormatProvider, Double) 方法分析具有特定样式的数字的字符串表示形式，并使用特定区域性的约定进行格式化。

string value;
NumberStyles style;
CultureInfo culture;
double number;

// Parse currency value using en-GB culture.
value = "£1,097.63";
style = NumberStyles.Number | NumberStyles.AllowCurrencySymbol;
culture = CultureInfo.CreateSpecificCulture("en-GB");
if (Double.TryParse(value, style, culture, out number))
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
   Console.WriteLine("Unable to convert '{0}'.", value);
// Displays:
//       Converted '£1,097.63' to 1097.63.

value = "1345,978";
style = NumberStyles.AllowDecimalPoint;
culture = CultureInfo.CreateSpecificCulture("fr-FR");
if (Double.TryParse(value, style, culture, out number))
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
   Console.WriteLine("Unable to convert '{0}'.", value);
// Displays:
//       Converted '1345,978' to 1345.978.

value = "1.345,978";
style = NumberStyles.AllowDecimalPoint | NumberStyles.AllowThousands;
culture = CultureInfo.CreateSpecificCulture("es-ES");
if (Double.TryParse(value, style, culture, out number))
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
   Console.WriteLine("Unable to convert '{0}'.", value);
// Displays:
//       Converted '1.345,978' to 1345.978.

value = "1 345,978";
if (Double.TryParse(value, style, culture, out number))
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
   Console.WriteLine("Unable to convert '{0}'.", value);
// Displays:
//       Unable to convert '1 345,978'.

// Parse currency value using en-GB culture.
let value = "£1,097.63"
let style = NumberStyles.Number ||| NumberStyles.AllowCurrencySymbol
let culture = CultureInfo.CreateSpecificCulture "en-GB"
match Double.TryParse(value, style, culture) with
| true, number ->
    printfn $"Converted '{value}' to {number}."
| _ ->
    printfn $"Unable to convert '{value}'."
// Displays:
//       Converted '£1,097.63' to 1097.63.

let value = "1345,978"
let style = NumberStyles.AllowDecimalPoint
let culture = CultureInfo.CreateSpecificCulture "fr-FR"
match Double.TryParse(value, style, culture) with
| true, number ->
    printfn $"Converted '{value}' to {number}."
| _ ->
    printfn $"Unable to convert '{value}'."
// Displays:
//       Converted '1345,978' to 1345.978.

let value = "1.345,978"
let style = NumberStyles.AllowDecimalPoint ||| NumberStyles.AllowThousands
let culture = CultureInfo.CreateSpecificCulture("es-ES")
match Double.TryParse(value, style, culture) with
| true, number ->
    printfn $"Converted '{value}' to {number}."
| _ ->
    printfn $"Unable to convert '{value}'."
// Displays:
//       Converted '1.345,978' to 1345.978.

let value = "1 345,978"
match Double.TryParse(value, style, culture) with
| true, number ->
    printfn $"Converted '{value}' to {number}."
| _ ->
    printfn $"Unable to convert '{value}'."
// Displays:
//       Unable to convert '1 345,978'.

Dim value As String
Dim style As NumberStyles
Dim culture As CultureInfo
Dim number As Double

' Parse currency value using en-GB culture.
value = "£1,097.63"
style = NumberStyles.Number Or NumberStyles.AllowCurrencySymbol
culture = CultureInfo.CreateSpecificCulture("en-GB")
If Double.TryParse(value, style, culture, number) Then
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
   Console.WriteLine("Unable to convert '{0}'.", value)
End If    
' Displays: 
'       Converted '£1,097.63' to 1097.63.

value = "1345,978"
style = NumberStyles.AllowDecimalPoint
culture = CultureInfo.CreateSpecificCulture("fr-FR")
If Double.TryParse(value, style, culture, number) Then
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
   Console.WriteLine("Unable to convert '{0}'.", value)
End If    
' Displays:
'       Converted '1345,978' to 1345.978.

value = "1.345,978"
style = NumberStyles.AllowDecimalPoint Or NumberStyles.AllowThousands
culture = CultureInfo.CreateSpecificCulture("es-ES")
If Double.TryParse(value, style, culture, number) Then
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
   Console.WriteLine("Unable to convert '{0}'.", value)
End If    
' Displays: 
'       Converted '1.345,978' to 1345.978.

value = "1 345,978"
If Double.TryParse(value, style, culture, number) Then
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
   Console.WriteLine("Unable to convert '{0}'.", value)
End If    
' Displays:
'       Unable to convert '1 345,978'.

注解

TryParse 方法类似于 Parse(String, NumberStyles, IFormatProvider) 方法，但此方法在转换失败时不会引发异常。如果转换成功，则返回值 true，并将 result 参数设置为转换的结果。如果转换失败，则返回值 false，result 参数设置为零。这消除了在 s 无效且无法成功分析的情况下使用异常处理来测试 FormatException 的需要。

style 参数定义 s 参数允许的格式，以便分析操作成功。它必须是 NumberStyles 枚举中的位标志的组合。不支持以下 NumberStyles 成员：

s 参数可以包含由 provider指示的区域性的 NumberFormatInfo.PositiveInfinitySymbol、NumberFormatInfo.NegativeInfinitySymbol或 NumberFormatInfo.NaNSymbol。此外，根据 style的值，s 参数可能包含以下元素：

[ws][$][sign][integral-digits，]integral-digits[.fractional-digits][e[sign]exponential-digits][ws]

方括号（[ 和 ]）中的元素是可选的。下表描述了每个元素。

元素	描述
ws	可选空格。如果 `style` 包含 NumberStyles.AllowLeadingWhite 标志，则空格可能会显示在 `s` 的开头。如果 `style` 包含 NumberStyles.AllowTrailingWhite 标志，则它可以显示在 `s` 末尾。
$	区域性特定的货币符号。字符串中的位置由 `provider` 参数 IFormatProvider.GetFormat 方法返回的 NumberFormatInfo 对象的 NumberFormatInfo.CurrencyNegativePattern 或 NumberFormatInfo.CurrencyPositivePattern 属性定义。如果 `style` 包含 NumberStyles.AllowCurrencySymbol 标志，货币符号可以出现在 `s` 中。
签名	可选符号。如果 `style` 包含 NumberStyles.AllowLeadingSign 标志，则符号可以在 `s` 开头显示，如果 `style` 包含 NumberStyles.AllowTrailingSign 标志，则它将显示在 `s` 末尾。如果 `style` 包含 NumberStyles.AllowParentheses 标志，则可以在 `s` 中使用括号来指示负值。
整型数字	一系列数字，范围从 0 到 9，用于指定数字的整部分。如果存在小数位数，则可以缺少整型数字。
、	区域性特定的千位分隔符符号。如果 `style` 包含 NumberStyles.AllowThousands 标志，则当前区域性的千位分隔符可以出现在 `s` 中。
。	区域性特定的小数点符号。如果 `style` 包含 NumberStyles.AllowDecimalPoint 标志，则当前区域性的小数点符号可以出现在 `s` 中。
小数位数	一系列数字，范围从 0 到 9，指定数字的小数部分。如果 `style` 包含 NumberStyles.AllowDecimalPoint 标志，则可以在 `s` 中显示小数位数。
e	e 或 E 字符，指示 `s` 可以使用指数表示法表示数字。如果样式包含 NumberStyles.AllowExponent 标志，`s` 参数可以表示指数表示法中的数字。
指数位数	一系列数字，范围从 0 到 9，用于指定指数。

注意

无论 style 参数的值如何，分析操作都会忽略 s 中任何终止的 NUL （U+0000）字符。

仅包含数字（对应于 NumberStyles.None 样式）的字符串在 Double 类型范围内时始终成功分析。其余 System.Globalization.NumberStyles 成员控制可能但不需要存在于输入字符串中的元素。下表指示单个 NumberStyles 标志如何影响 s中可能存在的元素。

NumberStyles 值	除数字外允许的元素
None	仅整型数字元素。
AllowDecimalPoint	。和小数位数元素。
AllowExponent	`s` 参数也可以使用指数表示法。此标志本身支持整数数字形式的值，E指数数字;需要使用其他标志以指数表示法成功分析字符串，这些元素包括正号或负号和小数点符号。
AllowLeadingWhite	`s`开头的 ws 元素。
AllowTrailingWhite	`s`末尾的 ws 元素。
AllowLeadingSign	`s`开头的符号元素。
AllowTrailingSign	`s`末尾的符号元素。
AllowParentheses	符号元素，以括住数值的括号形式。
AllowThousands	，元素。
AllowCurrencySymbol	$ 元素。
Currency	都。 `s` 参数不能表示十六进制数或指数表示法中的数字。
Float	ws 元素位于 `s`的开头或末尾，`s`开头符号，以及。符号。 `s` 参数也可以使用指数表示法。
Number	`ws`、`sign`、千位分隔符（，）、和小数点（.）元素。
Any	除 `s` 之外的所有样式都不能表示十六进制数。

provider 参数是 IFormatProvider 实现，例如 NumberFormatInfo 或 CultureInfo 对象。 provider 参数提供分析中使用的区域性特定信息。如果 providernull 或无法获取 NumberFormatInfo 对象，则使用当前区域性的格式信息。

如果 s 参数 null 或不是数值，provider 参数不会生成 NumberFormatInfo 对象，或者 style 参数不是 NumberStyles 枚举中的位标志的组合，则转换失败。

using System;

public class Example
{
   public static void Main()
   {
      string value;
      double number;

      value = Double.MinValue.ToString();
      if (Double.TryParse(value, out number))
         Console.WriteLine(number);
      else
         Console.WriteLine("{0} is outside the range of a Double.",
                           value);

      value = Double.MaxValue.ToString();
      if (Double.TryParse(value, out number))
         Console.WriteLine(number);
      else
         Console.WriteLine("{0} is outside the range of a Double.",
                           value);
   }
}
// The example displays the following output:
//    -1.79769313486232E+308 is outside the range of the Double type.
//    1.79769313486232E+308 is outside the range of the Double type.

open System

[<EntryPoint>]
let main _ = 
    let value = string Double.MinValue
    match Double.TryParse value with
    | true, number ->
        printfn $"{number}"
    | _ ->
        printfn $"{value} is outside the range of a Double."

    let value = string Double.MaxValue
    match Double.TryParse value with
    | true, number ->
        printfn $"{number}"
    | _ ->
        printfn $"{value} is outside the range of a Double."

    0
// The example displays the following output:
//    -1.79769313486232E+308 is outside the range of the Double type.
//    1.79769313486232E+308 is outside the range of the Double type.

Module Example
   Public Sub Main()
      Dim value As String
      Dim number As Double
      
      value = Double.MinValue.ToString()
      If Double.TryParse(value, number) Then
         Console.WriteLine(number)
      Else
         Console.WriteLine("{0} is outside the range of a Double.", _
                           value)
      End If
      
      value = Double.MaxValue.ToString()
      If Double.TryParse(value, number) Then
         Console.WriteLine(number)
      Else
         Console.WriteLine("{0} is outside the range of a Double.", _
                           value)
      End If
   End Sub
End Module
' The example displays the following output:
'    -1.79769313486232E+308 is outside the range of the Double type.
'    1.79769313486232E+308 is outside the range of the Double type.

在 .NET Framework 和 .NET Core 2.2 及更早版本中，如果 s 与 Double 数据类型的范围不同，Double.TryParse(String, NumberStyles, IFormatProvider, Double) 方法将引发 OverflowException。

在 .NET Core 3.0 及更高版本中，当 s 超过 Double 数据类型的范围时，不会引发异常。在大多数情况下，Double.TryParse(String, NumberStyles, IFormatProvider, Double) 方法计算 Double.PositiveInfinity 或 Double.NegativeInfinity的结果。但是，有一小组值被认为更接近 Double 的最大值或最小值，而不是正或负无穷大。在这些情况下，该方法计算 Double.MaxValue 或 Double.MinValue的结果。

如果在分析操作期间 s 参数中遇到分隔符，并且适用的货币或数字小数和组分隔符相同，则分析操作假定分隔符是小数分隔符，而不是组分隔符。有关分隔符的详细信息，请参阅 CurrencyDecimalSeparator、NumberDecimalSeparator、CurrencyGroupSeparator和 NumberGroupSeparator。

另请参阅

ToString()
分析 .NET 中的数值字符串

适用于

通过

Double.TryParse 方法

定义

重载

注解

TryParse(String, IFormatProvider, Double)

参数

返回

适用于

TryParse(ReadOnlySpan<Char>, Double)

参数

返回

注解

适用于

TryParse(String, Double)

参数

返回

示例

注解

另请参阅

适用于

TryParse(ReadOnlySpan<Byte>, IFormatProvider, Double)

参数

返回

适用于

TryParse(ReadOnlySpan<Char>, IFormatProvider, Double)

参数

返回

适用于

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

参数

返回

适用于

TryParse(ReadOnlySpan<Byte>, Double)

参数

返回

适用于

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

参数

返回

注解

适用于

TryParse(String, NumberStyles, IFormatProvider, Double)

参数

返回

例外

示例

注解

另请参阅

适用于

其他资源