Single.TryParse 方法

參考

定義

命名空間:: System

組件:: System.Runtime.dll

組件:: netstandard.dll

組件:: mscorlib.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

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

多載

TryParse(String, IFormatProvider, Single)	嘗試將字串剖析成值。
TryParse(ReadOnlySpan<Char>, Single)	將字元範圍中數位的字串表示轉換為其對等的單精度浮點數。傳回值表示轉換成功或失敗。
TryParse(String, Single)	將數位的字串表示轉換為其對等的單精度浮點數。傳回值表示轉換成功或失敗。
TryParse(ReadOnlySpan<Byte>, IFormatProvider, Single)	嘗試將UTF-8字元的範圍剖析為值。
TryParse(ReadOnlySpan<Char>, IFormatProvider, Single)	嘗試將字元範圍剖析成值。
TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, Single)	嘗試將UTF-8字元的範圍剖析為值。
TryParse(ReadOnlySpan<Byte>, Single)	嘗試將包含數位字串表示的UTF-8字元範圍轉換為其單精度浮點數對等專案。
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Single)	將指定樣式和特定文化特性格式的數位範圍表示轉換為其單精度浮點數對等專案。傳回值表示轉換成功或失敗。
TryParse(String, NumberStyles, IFormatProvider, Single)	將指定樣式和特定文化特性格式之數位的字串表示轉換為其單精度浮點數對等專案。傳回值表示轉換成功或失敗。

備註

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

TryParse(String, IFormatProvider, Single)

來源:: Single.cs

來源:: Single.cs

來源:: Single.cs

嘗試將字串剖析成值。

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

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

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

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

參數

s: String

要剖析的字串。

provider: IFormatProvider

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

result: Single

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

傳回

Boolean

如果已成功剖析 s，true;否則，false。

適用於

TryParse(ReadOnlySpan<Char>, Single)

來源:: Single.cs

來源:: Single.cs

來源:: Single.cs

將字元範圍中數位的字串表示轉換為其對等的單精度浮點數。傳回值表示轉換成功或失敗。

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

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

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

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

參數

s: ReadOnlySpan<Char>

>字元範圍，其中包含要轉換之數位的字串表示。

result: Single

當這個方法傳回時，如果轉換成功，則包含相當於 s 參數的單精度浮點數，如果轉換失敗，則為零。如果 s 參數是 null 或空白或不是有效格式的數位，則轉換會失敗。如果的有效數位小於 single.MinValue，。如果的有效數位大於 single.MaxValue，為。這個參數會未初始化傳遞;任何原本在 result 中提供的值都會遭到覆寫。

傳回

Boolean

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

備註

適用於

TryParse(String, Single)

來源:: Single.cs

來源:: Single.cs

來源:: Single.cs

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

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

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

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

static member TryParse : string * single -> bool

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

參數

s: String

字串，表示要轉換的數位。

result: Single

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

傳回

Boolean

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

範例

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

string value;
float number;

// Parse a floating-point value with a thousands separator.
value = "1,643.57";
if (Single.TryParse(value, out number))
   Console.WriteLine(number);
else
   Console.WriteLine("Unable to parse '{0}'.", value);

// Parse a floating-point value with a currency symbol and a
// thousands separator.
value = "$1,643.57";
if (Single.TryParse(value, out number))
   Console.WriteLine(number);
else
   Console.WriteLine("Unable to parse '{0}'.", value);

// Parse value in exponential notation.
value = "-1.643e6";
if (Single.TryParse(value, out number))
   Console.WriteLine(number);
else
   Console.WriteLine("Unable to parse '{0}'.", value);

// Parse a negative integer value.
value = "-168934617882109132";
if (Single.TryParse(value, out number))
   Console.WriteLine(number);
else
   Console.WriteLine("Unable to parse '{0}'.", value);
// The example displays the following output:
//       1643.57
//       Unable to parse '$1,643.57'.
//       -164300
//       -1.689346E+17

// Parse a floating-point value with a thousands separator.
let value = "1,643.57"
match Single.TryParse value with
| true, number ->
    printfn $"{number}"
| _ ->
    printfn $"Unable to parse '{value}'."

// Parse a floating-point value with a currency symbol and a
// thousands separator.
let value = "$1,643.57"
match Single.TryParse value with
| true, number ->
    printfn $"{number}"
| _ ->
    printfn $"Unable to parse '{value}'."

// Parse value in exponential notation.
let value = "-1.643e6"
match Single.TryParse value with
| true, number ->
    printfn $"{number}"
| _ ->
    printfn $"Unable to parse '{value}'."

// Parse a negative integer value.
let value = "-168934617882109132"
match Single.TryParse value with
| true, number ->
    printfn $"{number}"
| _ ->
    printfn $"Unable to parse '{value}'."
// The example displays the following output:
//       1643.57
//       Unable to parse '$1,643.57'.
//       -164300
//       -1.689346E+17

Dim value As String
Dim number As Single

' Parse a floating-point value with a thousands separator.
value = "1,643.57"
If Single.TryParse(value, number) Then
   Console.WriteLine(number)
Else
   Console.WriteLine("Unable to parse '{0}'.", value)
End If

' Parse a floating-point value with a currency symbol and a
' thousands separator.
value = "$1,643.57"
If Single.TryParse(value, number) Then
   Console.WriteLine(number)
Else
   Console.WriteLine("Unable to parse '{0}'.", value)
End If

' Parse value in exponential notation.
value = "-1.643e6"
If Single.TryParse(value, number)
   Console.WriteLine(number)
Else
   Console.WriteLine("Unable to parse '{0}'.", value)
End If

' Parse a negative integer number.
value = "-168934617882109132"
If Single.TryParse(value, number)
   Console.WriteLine(number)
Else
   Console.WriteLine("Unable to parse '{0}'.", value)
End If
' The example displays the following output:
'       1643.57
'       Unable to parse '$1,643.57'.
'       -1643000
'       -1.689346E+17

備註

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

s 參數可以包含 PositiveInfinitySymbol、NegativeInfinitySymbol、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中的元素（例如貨幣符號、千位分隔符和空格符），請使用 TryParse(String, NumberStyles, IFormatProvider, Single) 方法多載。

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

一般而言，如果您傳遞 Single.TryParse 方法，則會傳回透過呼叫 Single.ToString 方法所建立的字串，則會傳回原始 Single 值。不過，由於精確度遺失，值可能不相等。

如果 s 超出 Single 數據類型的範圍，此方法會在 .NET Framework 和 .NET Core 2.2 和舊版上傳回 false。在 .NET Core 3.0 和更新版本上，如果 s 小於 Single.MinValue，則會傳回 Single.NegativeInfinity，如果 s 大於 Single.MaxValue，則會傳回 Single.PositiveInfinity。

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

另請參閱

Parse(String)
ToString()
.NET 中剖析數值字串

適用於

TryParse(ReadOnlySpan<Byte>, IFormatProvider, Single)

來源:: Single.cs

來源:: Single.cs

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

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

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

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

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

參數

utf8Text: ReadOnlySpan<Byte>

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

provider: IFormatProvider

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

result: Single

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

傳回

Boolean

如果已成功剖析 utf8Text，true;否則，false。

適用於

TryParse(ReadOnlySpan<Char>, IFormatProvider, Single)

來源:: Single.cs

來源:: Single.cs

來源:: Single.cs

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

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

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

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

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

參數

s: ReadOnlySpan<Char>

要剖析的字元範圍。

provider: IFormatProvider

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

result: Single

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

傳回

Boolean

如果已成功剖析 s，true;否則，false。

適用於

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

來源:: Single.cs

來源:: Single.cs

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

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

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

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

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

參數

utf8Text: ReadOnlySpan<Byte>

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

style: NumberStyles

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

provider: IFormatProvider

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

result: Single

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

傳回

Boolean

如果已成功剖析 utf8Text，true;否則，false。

適用於

TryParse(ReadOnlySpan<Byte>, Single)

來源:: Single.cs

來源:: Single.cs

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

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

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

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

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

參數

utf8Text: ReadOnlySpan<Byte>

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

result: Single

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

傳回

Boolean

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

適用於

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

來源:: Single.cs

來源:: Single.cs

來源:: Single.cs

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

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

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

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

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

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

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

參數

s: ReadOnlySpan<Char>

唯讀字元範圍，其中包含要轉換的數位。範圍是使用 style所指定的樣式來解譯。

style: NumberStyles

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

provider: IFormatProvider

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

result: Single

當這個方法傳回時，如果轉換成功，則包含相當於 s中所含數值或符號的單精度浮點數，如果轉換失敗，則為零。如果 s 參數是 null 或 Empty，則轉換會失敗，不符合 style的格式，代表小於 single.MinValue 或大於 Single.MaxValue的數位，或者如果 style 不是 NumberStyles 列舉常數的有效組合。這個參數會未初始化傳遞;任何原本在 result 中提供的值都會遭到覆寫。

傳回

Boolean

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

備註

適用於

TryParse(String, NumberStyles, IFormatProvider, Single)

來源:: Single.cs

來源:: Single.cs

來源:: Single.cs

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

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

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

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

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

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

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

參數

s: String

字串，表示要轉換的數位。

style: NumberStyles

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

provider: IFormatProvider

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

result: Single

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

傳回

Boolean

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

例外狀況

ArgumentException

style 不是 NumberStyles 值。

-或-

style 是 AllowHexSpecifier 值。

範例

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

string value;
System.Globalization.NumberStyles style;
System.Globalization.CultureInfo culture;
float number;

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

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

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

value = "1 345,978";
if (Single.TryParse(value, style, culture, out number))
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
   Console.WriteLine("Unable to convert '{0}'.", value);
// The example displays the following output:
//       Converted '£1,097.63' to 1097.63.
//       Converted '1345,978' to 1345.978.
//       Converted '1.345,978' to 1345.978.
//       Unable to convert '1 345,978'.

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

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

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

let value = "1 345,978"
match Single.TryParse(value, style, culture) with
| true, number ->
    printfn $"Converted '{value}' to {number}."
| _ ->
    printfn $"Unable to convert '{value}'."
// The example displays the following output:
//       Converted '£1,097.63' to 1097.63.
//       Converted '1345,978' to 1345.978.
//       Converted '1.345,978' to 1345.978.
//       Unable to convert '1 345,978'.

Dim value As String
Dim style As System.Globalization.NumberStyles
Dim culture As System.Globalization.CultureInfo
Dim number As Single

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

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

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

value = "1 345,978"
If Single.TryParse(value, style, culture, number) Then
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
   Console.WriteLine("Unable to convert '{0}'.", value)
End If
' The example displays the following output:
'       Converted '£1,097.63' to 1097.63.
'       Converted '1345,978' to 1345.978.
'       Converted '1.345,978' to 1345.978.
'       Unable to convert '1 345,978'.

備註

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

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

s 參數可以包含 provider所指示文化特性的 PositiveInfinitySymbol、NegativeInfinitySymbol 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` 結尾。括弧可用於 `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 樣式），如果字串位於 Single 類型的範圍，則一律會成功剖析。其餘 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 實作，其 GetFormat 方法會傳回提供特定文化特性格式資訊的 NumberFormatInfo 物件。叫用 TryParse(String, NumberStyles, IFormatProvider, Single) 方法時，它會呼叫 provider 參數的 GetFormat 方法，並傳遞代表 NumberFormatInfo 類型的 Type 物件。 GetFormat 方法接著會傳回 NumberFormatInfo 物件，該物件會提供 s 參數格式的相關信息。有三種方式可以使用 provider 參數，將自定義格式資訊提供給剖析作業：

您可以傳遞代表提供格式資訊之文化特性的 CultureInfo 物件。其 GetFormat 方法會傳回 NumberFormatInfo 物件，該物件會提供該文化特性的數值格式資訊。
您可以傳遞提供數值格式資訊的實際 NumberFormatInfo 物件。（其實作 GetFormat 只傳回自己。
您可以傳遞實作 IFormatProvider的自訂物件。其 GetFormat 方法會具現化，並傳回提供格式化資訊的 NumberFormatInfo 物件。

如果 provider 是 null，則會根據目前文化特性的 NumberFormatInfo 對象來解譯 s 的格式。

如果 s 超出 Single 數據類型的範圍，此方法會在 .NET Framework 和 .NET Core 2.2 和舊版上擲回 OverflowException。在 .NET Core 3.0 和更新版本上，如果 s 小於 Single.MinValue，則會傳回 Single.NegativeInfinity，如果 s 大於 Single.MaxValue，則會傳回 Single.PositiveInfinity。

另請參閱

Parse(String)
ToString()
.NET 中剖析數值字串

適用於

共用方式為

Single.TryParse 方法

定義

多載

備註

TryParse(String, IFormatProvider, Single)

參數

傳回

適用於

TryParse(ReadOnlySpan<Char>, Single)

參數

傳回

備註

適用於

TryParse(String, Single)

參數

傳回

範例

備註

另請參閱

適用於

TryParse(ReadOnlySpan<Byte>, IFormatProvider, Single)

參數

傳回

適用於

TryParse(ReadOnlySpan<Char>, IFormatProvider, Single)

參數

傳回

適用於

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

參數

傳回

適用於

TryParse(ReadOnlySpan<Byte>, Single)

參數

傳回

適用於

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

參數

傳回

備註

適用於

TryParse(String, NumberStyles, IFormatProvider, Single)

參數

傳回

例外狀況

範例

備註

另請參閱

適用於

其他資源