閱讀英文

共用方式為


Double.TryParse 方法

定義

將數位的字串表示轉換為其對等的雙精確度浮點數。 傳回值表示轉換成功或失敗。

多載

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 規格所需的 PositiveInfinityNegativeInfinity。 在舊版中,包括 .NET Framework,剖析的值太大而無法表示導致失敗。

TryParse(String, IFormatProvider, Double)

來源:
Double.cs
來源:
Double.cs
來源:
Double.cs

嘗試將字串剖析成值。

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

參數

s
String

要剖析的字串。

provider
IFormatProvider

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

result
Double

當這個方法傳回時,包含成功剖析 s 或失敗時未定義值的結果。

傳回

如果已成功剖析 strue;否則,false

適用於

.NET 10 及其他版本
產品 版本
.NET 7, 8, 9, 10

TryParse(ReadOnlySpan<Char>, Double)

來源:
Double.cs
來源:
Double.cs
來源:
Double.cs

將指定樣式和特定文化特性格式的數位範圍表示轉換為其對等的雙精確度浮點數。 傳回值表示轉換成功或失敗。

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

參數

s
ReadOnlySpan<Char>

字元範圍,包含要轉換之數位的字串表示。

result
Double

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

傳回

如果成功轉換 strue;否則,false

備註

在 .NET Core 3.0 和更新版本中,太大而無法表示的值會四捨五入為 IEEE 754 規格所需的 PositiveInfinityNegativeInfinity。 在舊版中,包括 .NET Framework,剖析的值太大而無法表示導致失敗。

適用於

.NET 10 及其他版本
產品 版本
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Standard 2.1

TryParse(String, Double)

來源:
Double.cs
來源:
Double.cs
來源:
Double.cs

將數位的字串表示轉換為其對等的雙精確度浮點數。 傳回值表示轉換成功或失敗。

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

參數

s
String

字串,包含要轉換的數位。

result
Double

當這個方法傳回時,如果轉換成功,則包含相當於 s 參數的雙精確度浮點數,如果轉換失敗,則為零。 如果 s 參數是 nullEmpty 或不是有效格式的數位,則轉換會失敗。 如果 .NET Framework 和 .NET Core 2.2 和舊版 s 代表小於 Double.MinValue 或大於 Double.MaxValue的數位,它也會失敗。 這個參數會未初始化傳遞;任何原本在 result 中提供的值都會遭到覆寫。

傳回

如果成功轉換 strue;否則,false

範例

下列範例會使用 TryParse(String, Double) 方法,將數值的字串表示轉換成 Double 值。 它假設 en-US 是目前的文化特性。

C#
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'.

備註

在 .NET Core 3.0 和更新版本中,太大而無法表示的值會四捨五入為 IEEE 754 規格所需的 PositiveInfinityNegativeInfinity。 在舊版中,包括 .NET Framework,剖析的值太大而無法表示導致失敗。

這個多載與 Double.Parse(String) 方法不同,方法是傳回布爾值,指出剖析作業是否成功,而不是傳回剖析的數值。 它不需要使用例外狀況處理來測試 FormatExceptions 無效且無法成功剖析。

s 參數可以包含目前文化特性的 NumberFormatInfo.PositiveInfinitySymbolNumberFormatInfo.NegativeInfinitySymbolNumberFormatInfo.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.FloatNumberStyles.AllowThousands 旗標的組合來解譯。 這表示允許空格符和千位分隔符,但貨幣符號則不允許。 若要明確定義可以存在於 s中的元素(例如貨幣符號、千位分隔符和空格符),請使用 Double.TryParse(String, NumberStyles, IFormatProvider, Double) 方法多載。

s 參數是使用目前系統文化特性初始化之 NumberFormatInfo 物件中的格式資訊來剖析。 如需詳細資訊,請參閱 NumberFormatInfo.CurrentInfo。 若要使用其他指定文化特性的格式資訊剖析字串,請使用 Double.TryParse(String, NumberStyles, IFormatProvider, Double) 方法多載。

一般而言,如果您傳遞 Double.TryParse 方法,則會傳回透過呼叫 Double.ToString 方法所建立的字串,則會傳回原始 Double 值。 不過,由於精確度遺失,值可能不相等。 此外,嘗試剖析 Double.MinValueDouble.MaxValue 的字串表示無法往返。 在 .NET Framework 和 .NET Core 2.2 和舊版上,它會擲回 OverflowException。 在 .NET Core 3.0 和更新版本上,如果您嘗試剖析 MinValue 或嘗試剖析 MaxValue,則會傳回 Double.PositiveInfinityDouble.NegativeInfinity。 下列範例提供圖例。

C#
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.

在 .NET Framework 和 .NET Core 2.2 和舊版上,如果 s 超出 Double 數據類型的範圍,TryParse(String, Double) 方法會擲回 OverflowException

在 .NET Core 3.0 和更新版本上,當 s 超出 Double 數據類型的範圍時,不會擲回任何例外狀況。 在大部分情況下,TryParse(String, Double) 方法會計算 Double.PositiveInfinityDouble.NegativeInfinity的結果。 不過,有一組小的值會被視為接近 Double 最大值或最小值,而不是正數或負無限大。 在這些情況下,方法會計算 Double.MaxValueDouble.MinValue的結果。

如果在剖析作業期間 s 參數中遇到分隔符,而且小數和群組分隔符相同,剖析作業會假設分隔符是小數分隔符,而不是群組分隔符。 如需分隔符的詳細資訊,請參閱 CurrencyDecimalSeparatorNumberDecimalSeparatorCurrencyGroupSeparatorNumberGroupSeparator

另請參閱

適用於

.NET 10 及其他版本
產品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

TryParse(ReadOnlySpan<Byte>, IFormatProvider, Double)

來源:
Double.cs
來源:
Double.cs

嘗試將UTF-8字元的範圍剖析為值。

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

參數

utf8Text
ReadOnlySpan<Byte>

要剖析的UTF-8字元範圍。

provider
IFormatProvider

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

result
Double

傳回時,包含成功剖析 utf8Text 或失敗時未定義值的結果。

傳回

如果已成功剖析 utf8Texttrue;否則,false

適用於

.NET 10 及其他版本
產品 版本
.NET 8, 9, 10

TryParse(ReadOnlySpan<Char>, IFormatProvider, Double)

來源:
Double.cs
來源:
Double.cs
來源:
Double.cs

嘗試將字元範圍剖析成值。

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

參數

s
ReadOnlySpan<Char>

要剖析的字元範圍。

provider
IFormatProvider

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

result
Double

當這個方法傳回時,包含成功剖析 s的結果,或失敗時未定義的值。

傳回

如果已成功剖析 strue;否則,false

適用於

.NET 10 及其他版本
產品 版本
.NET 7, 8, 9, 10

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

來源:
Double.cs
來源:
Double.cs

嘗試將UTF-8字元的範圍剖析為值。

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

參數

utf8Text
ReadOnlySpan<Byte>

要剖析的UTF-8字元範圍。

style
NumberStyles

數字樣式的位元組合,可以存在於 utf8Text中。

provider
IFormatProvider

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

result
Double

傳回時,包含成功剖析 utf8Text 或失敗時未定義值的結果。

傳回

如果已成功剖析 utf8Texttrue;否則,false

適用於

.NET 10 及其他版本
產品 版本
.NET 8, 9, 10

TryParse(ReadOnlySpan<Byte>, Double)

來源:
Double.cs
來源:
Double.cs

嘗試將包含數位字串表示的UTF-8字元範圍轉換為其對等雙精確度浮點數。

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

參數

utf8Text
ReadOnlySpan<Byte>

唯讀 UTF-8 字元範圍,其中包含要轉換的數位。

result
Double

當這個方法傳回時,如果轉換成功,則包含相當於 utf8Text 中所含數值或符號的雙精確度浮點數,如果轉換失敗,則為零。 如果 utf8TextEmpty 或不是有效的格式,轉換就會失敗。 這個參數會未初始化傳遞;將覆寫原本在結果中提供的任何值。

傳回

如果成功轉換 utf8Texttrue;否則,false

適用於

.NET 10 及其他版本
產品 版本
.NET 8, 9, 10

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

來源:
Double.cs
來源:
Double.cs
來源:
Double.cs

將包含指定樣式和特定文化特性格式之數位的字串表示的字元範圍轉換為其對等的雙精確度浮點數。 傳回值表示轉換成功或失敗。

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

參數

s
ReadOnlySpan<Char>

唯讀字元範圍,其中包含要轉換的數位。

style
NumberStyles

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

provider
IFormatProvider

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

result
Double

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

傳回

如果成功轉換 strue;否則,false

備註

在 .NET Core 3.0 和更新版本中,太大而無法表示的值會四捨五入為 IEEE 754 規格所需的 PositiveInfinityNegativeInfinity。 在舊版中,包括 .NET Framework,剖析的值太大而無法表示導致失敗。

適用於

.NET 10 及其他版本
產品 版本
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Standard 2.1

TryParse(String, NumberStyles, IFormatProvider, Double)

來源:
Double.cs
來源:
Double.cs
來源:
Double.cs

將指定樣式和特定文化特性格式之數位的字串表示轉換為其對等的雙精確度浮點數。 傳回值表示轉換成功或失敗。

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

參數

s
String

字串,包含要轉換的數位。

style
NumberStyles

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

provider
IFormatProvider

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

result
Double

當這個方法傳回時,如果轉換成功,則包含與 s中包含的數值或符號相等的雙精確度浮點數,如果轉換成功,則為零。 如果 s 參數 nullEmpty 或格式不符合 style,或 style 不是 NumberStyles 列舉常數的有效組合,則轉換會失敗。 如果 .NET Framework 或 .NET Core 2.2 和舊版 s 代表小於 SByte.MinValue 的數位, 或大於 SByte.MaxValue,它也會失敗。 這個參數會未初始化傳遞;任何原本在 result 中提供的值都會遭到覆寫。

傳回

如果成功轉換 strue;否則,false

例外狀況

style 不是 NumberStyles 值。

-或-

style 包含 AllowHexSpecifier 值。

範例

下列範例示範如何使用 Double.TryParse(String, NumberStyles, IFormatProvider, Double) 方法來剖析具有特定樣式的數位字串表示,並使用特定文化特性的慣例來格式化。

C#
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'.

備註

在 .NET Core 3.0 和更新版本中,太大而無法表示的值會四捨五入為 IEEE 754 規格所需的 PositiveInfinityNegativeInfinity。 在舊版中,包括 .NET Framework,剖析的值太大而無法表示導致失敗。

TryParse 方法就像 Parse(String, NumberStyles, IFormatProvider) 方法,但此方法不會在轉換失敗時擲回例外狀況。 如果轉換成功,則會 true 傳回值,並將 result 參數設定為轉換的結果。 如果轉換失敗,則會 false 傳回值,並將 result 參數設定為零。 這可避免在 s 無效且無法成功剖析的情況下,使用例外狀況處理來測試 FormatException

style 參數會定義 s 參數允許的格式,讓剖析作業成功。 它必須是來自 NumberStyles 列舉的位旗標組合。 不支援下列 NumberStyles 成員:

s 參數可以包含 NumberFormatInfo.PositiveInfinitySymbolNumberFormatInfo.NegativeInfinitySymbolNumberFormatInfo.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.CurrencyNegativePatternNumberFormatInfo.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 wssign、千位分隔符(、)、 和小數點(.) 元素。
Any 除了 s 以外的所有樣式都不能代表十六進位數。

provider 參數是 IFormatProvider 實作,例如 NumberFormatInfoCultureInfo 物件。 provider 參數會提供剖析中使用的文化特性特定資訊。 如果 providernull 或無法取得 NumberFormatInfo 物件,則會使用目前文化特性的格式資訊。

如果 s 參數 null 或不是數值,provider 參數不會產生 NumberFormatInfo 物件,或 style 參數不是來自 NumberStyles 列舉的位旗標組合,則轉換會失敗。

一般而言,如果您傳遞 Double.TryParse 方法,則會傳回透過呼叫 Double.ToString 方法所建立的字串,則會傳回原始 Double 值。 不過,由於精確度遺失,值可能不相等。 此外,嘗試剖析 Double.MinValueDouble.MaxValue 的字串表示無法往返。 在 .NET Framework 和 .NET Core 2.2 和舊版上,它會擲回 OverflowException。 在 .NET Core 3.0 和更新版本上,如果您嘗試剖析 MinValue 或嘗試剖析 MaxValue,則會傳回 Double.PositiveInfinityDouble.NegativeInfinity。 下列範例提供圖例。

C#
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.

在 .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.PositiveInfinityDouble.NegativeInfinity的結果。 不過,有一組小的值會被視為接近 Double 最大值或最小值,而不是正數或負無限大。 在這些情況下,方法會計算 Double.MaxValueDouble.MinValue的結果。

如果在剖析作業期間 s 參數中遇到分隔符,而且適用的貨幣或數位十進位和群組分隔符相同,剖析作業會假設分隔符是小數分隔符,而不是群組分隔符。 如需分隔符的詳細資訊,請參閱 CurrencyDecimalSeparatorNumberDecimalSeparatorCurrencyGroupSeparatorNumberGroupSeparator

另請參閱

適用於

.NET 10 及其他版本
產品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0