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)

來源:: Double.cs

來源:: Double.cs

來源:: 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)

來源:: Double.cs

來源:: Double.cs

來源:: 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的有效數位，result 為 NegativeInfinity。如果的有效數位大於 double.MaxValue，為。這個參數會未初始化傳遞;任何原本在 result 中提供的值都會遭到覆寫。

傳回

Boolean

如果成功轉換 s，true;否則，false。

備註

適用於

TryParse(String, Double)

來源:: Double.cs

來源:: Double.cs

來源:: 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 或不是有效格式的數位，則轉換會失敗。如果 .NET Framework 和 .NET Core 2.2 和舊版 s 代表小於 Double.MinValue 或大於 Double.MaxValue的數位，它也會失敗。這個參數會未初始化傳遞;任何原本在 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) 方法不同，方法是傳回布爾值，指出剖析作業是否成功，而不是傳回剖析的數值。它不需要使用例外狀況處理來測試 FormatException，s 無效且無法成功剖析。

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 或嘗試剖析 MaxValue，則會傳回 Double.PositiveInfinity 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)

來源:: Double.cs

來源:: 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)

來源:: Double.cs

來源:: Double.cs

來源:: 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)

來源:: Double.cs

來源:: 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)

來源:: Double.cs

來源:: 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 中所含數值或符號的雙精確度浮點數，如果轉換失敗，則為零。如果 utf8Text 是 Empty 或不是有效的格式，轉換就會失敗。這個參數會未初始化傳遞;將覆寫原本在結果中提供的任何值。

傳回

Boolean

如果成功轉換 utf8Text，true;否則，false。

適用於

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

來源:: Double.cs

來源:: Double.cs

來源:: 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

NumberStyles 值的位元組合，表示 s允許的格式。要指定的一般值會與 AllowThousands結合 Float。

provider: IFormatProvider

物件，提供與 s相關的特定文化特性格式資訊。

result: Double

當這個方法傳回時，如果轉換成功，則包含相當於 s中之數值或符號的雙精確度浮點數。如果轉換失敗，則包含零。如果 s 參數是 null、空字元範圍，或是格式與 style相容的數位，則轉換會失敗。如果 s 為小於 Double.MinValue的有效數位，result 為 NegativeInfinity。如果的有效數位大於 double.MaxValue，為。這個參數會未初始化傳遞;任何原本在 result 中提供的值都會遭到覆寫。

傳回

Boolean

如果成功轉換 s，true;否則，false。

備註

適用於

TryParse(String, NumberStyles, IFormatProvider, Double)

來源:: Double.cs

來源:: Double.cs

來源:: 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

NumberStyles 值的位元組合，表示 s允許的格式。要指定的一般值會與 AllowThousands結合 Float。

provider: IFormatProvider

IFormatProvider，提供與 s相關的特定文化特性格式資訊。

result: Double

當這個方法傳回時，如果轉換成功，則包含與 s中包含的數值或符號相等的雙精確度浮點數，如果轉換成功，則為零。如果 s 參數 null 或 Empty 或格式不符合 style，或 style 不是 NumberStyles 列舉常數的有效組合，則轉換會失敗。如果 .NET Framework 或 .NET Core 2.2 和舊版 s 代表小於 SByte.MinValue 的數位，或大於 SByte.MaxValue，它也會失敗。這個參數會未初始化傳遞;任何原本在 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 參數可以包含 NumberFormatInfo.PositiveInfinitySymbol、NumberFormatInfo.NegativeInfinitySymbol或 NumberFormatInfo.NaNSymbol，以表示 provider。此外，根據 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` 結尾。括弧可用於 `s`，如果 `style` 包含 NumberStyles.AllowParentheses 旗標，則表示負值。
整數數位	一系列數位，範圍從 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 ws 專案。
AllowTrailingWhite	`s`結尾的 ws 專案。
AllowLeadingSign	`s`開頭的符號專案。
AllowTrailingSign	`s`結尾處的符號專案。
AllowParentheses	以括弧括住數值的括弧形式，符號專案。
AllowThousands	、專案。
AllowCurrencySymbol	$ 專案。
Currency	都。 `s` 參數不能代表十六進位數或指數表示法的數位。
Float	`s`開頭或結尾的 ws 專案，`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)

參數

傳回

例外狀況

範例

備註

另請參閱

適用於

其他資源