Single.TryParse メソッド

定義

数値の文字列形式を、それと等価な単精度浮動小数点数に変換します。 戻り値は変換が成功したか失敗したかを示します。

オーバーロード

TryParse(ReadOnlySpan<Char>, IFormatProvider, Single)

文字のスパンを値に解析しようとします。

TryParse(ReadOnlySpan<Char>, Single)

文字スパン内の数値の文字列表現を、それと等価の単精度浮動小数点数に変換します。 戻り値は変換が成功したか失敗したかを示します。

TryParse(String, Single)

数値の文字列形式を、それと等価な単精度浮動小数点数に変換します。 戻り値は変換が成功したか失敗したかを示します。

TryParse(ReadOnlySpan<Byte>, IFormatProvider, Single)

UTF-8 文字のスパンを値に解析しようとします。

TryParse(String, 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 仕様で必要に応じて または NegativeInfinityPositiveInfinity丸められます。 .NET Frameworkを含む以前のバージョンでは、大きすぎる値を解析するとエラーが発生しました。

TryParse(ReadOnlySpan<Char>, IFormatProvider, Single)

Source:
Single.cs
Source:
Single.cs
Source:
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された結果、または失敗した場合に未定義の値が格納されます。

戻り値

true が正常に解析された場合 s は 。それ以外の場合 falseは 。

適用対象

TryParse(ReadOnlySpan<Char>, Single)

Source:
Single.cs
Source:
Single.cs
Source:
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 パラメーターの値と等価の単精度浮動小数点数を格納します。変換に失敗した場合は 0 を格納します。 s パラメーターが null か空の場合、または有効な形式の数値でない場合、変換は失敗します。 が Single.MinValue より小さい有効な数値の場合sresult は ですNegativeInfinity。 が Single.MaxValue より大きい有効な数値の場合sresult は ですPositiveInfinity。 このパラメーターは初期化されていない状態で渡されています。result で最初に指定された任意の値が上書きされます。

戻り値

s が正常に変換された場合は true。それ以外の場合は false

注釈

.NET Core 3.0 以降では、表すには大きすぎる値は、IEEE 754 仕様で必要に応じて または NegativeInfinityPositiveInfinity丸められます。 .NET Frameworkを含む以前のバージョンでは、大きすぎる値を解析するとエラーが発生しました。

適用対象

TryParse(String, Single)

Source:
Single.cs
Source:
Single.cs
Source:
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 に格納された数値または記号に等しい単精度浮動小数点数を格納します。変換に失敗した場合は 0 を格納します。 s パラメーターが null または Empty の場合、または有効な形式の数値でない場合、変換は失敗します。 また、Single.MinValue より小さい数値または Single.MaxValue より大きい値を表す場合sは、.NET Framework および .NET Core 2.2 以前のバージョンでも失敗します。 このパラメーターは初期化されていない状態で渡されています。result で最初に指定された任意の値が上書きされます。

戻り値

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

注釈

.NET Core 3.0 以降では、表すには大きすぎる値は、IEEE 754 仕様で必要に応じて または NegativeInfinityPositiveInfinity丸められます。 .NET Frameworkを含む以前のバージョンでは、大きすぎる値を解析するとエラーが発生しました。

このオーバーロードは、解析された数値を Single.Parse(String) 返す代わりに解析操作が成功したかどうかを示すブール値を返すことによって、メソッドとは異なります。 例外処理を使用して、 が無効で正常に解析できないイベントsで をテストFormatExceptionする必要がなくなります。

パラメーターにはs、、、 NegativeInfinitySymbolNaNSymbol (文字列比較では大文字と小文字が区別されます)、または形式の文字列を含PositiveInfinitySymbolめることができます。

[ws][sign][整数桁,]整数桁[.[小数部]][e[符号]指数桁][ws]

角かっこ内の要素は省略可能です。 次の表は、それぞれの要素の説明です。

要素 説明
ws 一連の空白文字。
sign 負符号または正符号記号。
整数桁 数値の整数部分を指定する 0 から 9 までの一連の数値。 整数桁は、小数部がある場合は使用できません。
, カルチャ固有のグループ区切り記号。
. カルチャ固有の小数点記号。
小数部の数字 数値の小数部を指定する 0 から 9 までの一連の数値。
E 指数 (指数) 表記を示す大文字または小文字の 'e'。
exponential-digits 指数を指定する 0 ~ 9 の範囲の一連の数値。

パラメーターはs、 フラグと NumberStyles.AllowThousands フラグのNumberStyles.Float組み合わせを使用して解釈されます。 つまり、空白と桁区切り記号は使用できますが、通貨記号は使用できません。 に存在できる要素 (通貨記号、桁区切り記号、空白など) を明示的に s定義するには、 メソッドのオーバーロードを TryParse(String, NumberStyles, IFormatProvider, Single) 使用します。

パラメーターは s 、現在のシステム カルチャ用に初期化された オブジェクトの NumberFormatInfo 書式設定情報を使用して解析されます。 詳細については、「NumberFormatInfo.CurrentInfo」を参照してください。 指定した他のカルチャの書式設定情報を使用して文字列を解析するには、 メソッドオーバーロードを使用します TryParse(String, NumberStyles, IFormatProvider, Single)

通常、 メソッドを Single.TryParse 呼び出して作成された文字列をメソッドに Single.ToString 渡すと、元 Single の値が返されます。 ただし、精度が失われるため、値が等しくない可能性があります。

がデータ型の範囲外のSingle場合s、メソッドは .NET Framework および .NET Core 2.2 以前のバージョンで を返falseします。 .NET Core 3.0 以降のバージョンでは、 が よりSingle.PositiveInfinitySingle.MinValue小さく、 が より大きいSingle.MaxValue場合は をsSingle.NegativeInfinitysします。

解析操作中にパラメーターで s 区切り記号が検出され、該当する通貨または数値の小数点とグループの区切り記号が同じ場合、解析操作では、区切り記号がグループ区切り記号ではなく小数点の区切り記号であると見なされます。 区切り記号の詳細については、「、、、および 」を参照してくださいCurrencyDecimalSeparatorCurrencyGroupSeparatorNumberDecimalSeparatorNumberGroupSeparator

こちらもご覧ください

適用対象

TryParse(ReadOnlySpan<Byte>, IFormatProvider, Single)

Source:
Single.cs
Source:
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 された結果、または失敗した場合に未定義の値が含まれます。

戻り値

true が正常に解析された場合 utf8Text は 。それ以外の場合 falseは 。

適用対象

TryParse(String, IFormatProvider, Single)

Source:
Single.cs
Source:
Single.cs
Source:
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 された結果または失敗した場合は未定義の値が格納されます。

戻り値

true 正常に解析された場合 s は 。それ以外の場合 falseは 。

適用対象

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

Source:
Single.cs
Source:
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 された結果または失敗した場合の未定義の値が含まれます。

戻り値

true 正常に解析された場合 utf8Text は 。それ以外の場合 falseは 。

適用対象

TryParse(ReadOnlySpan<Byte>, Single)

Source:
Single.cs
Source:
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

このメソッドが戻るときに、 には、変換が成功した場合は に含まれる数値または記号に相当する単精度浮動小数点数が格納され、変換に失敗した場合は 0 が格納 utf8Text されます。 が Empty であるか、有効な形式でない場合utf8Text、変換は失敗します。 このパラメーターは、初期化されていない状態で渡されます。result にもともと入っていた値は上書きされます。

戻り値

utf8Text が正常に変換された場合は true。それ以外の場合は false

適用対象

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

Source:
Single.cs
Source:
Single.cs
Source:
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 に格納された数値または記号に等しい単精度浮動小数点数を格納します。変換に失敗した場合は 0 を格納します。 パラメーターが または である場合、または Emptynull に準拠styleしている形式でない場合s、または Single.MinValue より小さい数値または Single.MaxValue より大きい数値を表す場合、またはが列挙定数のNumberStyles有効な組み合わせでない場合style、変換は失敗します。 このパラメーターは初期化されていない状態で渡されています。result で最初に指定された任意の値が上書きされます。

戻り値

s が正常に変換された場合は true。それ以外の場合は false

注釈

.NET Core 3.0 以降では、表すには大きすぎる値は、IEEE 754 仕様で必要に応じて または NegativeInfinityPositiveInfinity丸められます。 .NET Frameworkを含む以前のバージョンでは、大きすぎる値を解析するとエラーが発生しました。

適用対象

TryParse(String, NumberStyles, IFormatProvider, Single)

Source:
Single.cs
Source:
Single.cs
Source:
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 に格納された数値または記号に等しい単精度浮動小数点数を格納します。変換に失敗した場合は 0 を格納します。 s パラメーターが null または Empty の場合、style に準拠する形式ではない場合、または styleNumberStyles 列挙定数の有効な組み合わせでない場合、変換は失敗します。 また、Single.MinValue より小さい数値または Single.MaxValue より大きい数値を表す場合sは、.NET Frameworkまたは .NET Core 2.2 以前のバージョンでも失敗します。 このパラメーターは初期化されていない状態で渡されています。result で最初に指定された任意の値が上書きされます。

戻り値

s が正常に変換された場合は true。それ以外の場合は false

例外

styleNumberStyles 値ではありません。

または

styleAllowHexSpecifier 値です。

次の例では、 メソッドを 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'.

注釈

.NET Core 3.0 以降では、表すには大きすぎる値は、IEEE 754 仕様で必要に応じて または NegativeInfinityPositiveInfinity丸められます。 .NET Frameworkを含む以前のバージョンでは、大きすぎる値を解析するとエラーが発生しました。

このオーバーロードは、解析された数値を Parse(String, NumberStyles, IFormatProvider) 返す代わりに解析操作が成功したかどうかを示すブール値を返すことで、メソッドとは異なります。 無効であり、正常に解析できないイベントsで 例外処理を使用して をテストFormatExceptionする必要がなくなります。

パラメーターは style 、解析操作を成功させるパラメーターの s 許容される形式を定義します。 列挙体のビット フラグ NumberStyles の組み合わせである必要があります。 次 NumberStyles のメンバーはサポートされていません。

パラメーターにはs、 でprovider示されるカルチャの 、 NaNSymbolNegativeInfinitySymbolを含PositiveInfinitySymbolめることができます。 さらに、 の style値に応じて、 パラメーターに s 次の要素を含めることができます。

[ws][$][sign][整数桁,]整数桁[.分数桁数][e[符号]指数桁][ws]

角かっこ ([ および ]) 内の要素は省略可能です。 次の表は、それぞれの要素の説明です。

要素 説明
ws オプションの空白。 フラグが含まれている場合styleは、 のs先頭に空白をNumberStyles.AllowLeadingWhite表示できます。 フラグが含まれている場合styleは、 のs末尾にNumberStyles.AllowTrailingWhite表示されます。
$ カルチャ固有の通貨記号。 文字列内の位置は、 パラメーターの NumberFormatInfo.CurrencyNegativePattern メソッドproviderによって返される オブジェクトの NumberFormatInfo または NumberFormatInfo.CurrencyPositivePattern プロパティによってIFormatProvider.GetFormat定義されます。 に フラグが含まれている場合styleは、通貨記号を にsNumberStyles.AllowCurrencySymbol表示できます。
sign 省略可能な記号。 署名は、 フラグを含む場合は のs先頭に表示され、フラグが含NumberStyles.AllowLeadingSignまれている場合styleは のs末尾にNumberStyles.AllowTrailingSign表示styleされます。 に フラグが含まれている場合styleは、かっこを使用sして負の値をNumberStyles.AllowParentheses示すことができます。
整数桁 数値の整数部分を指定する 0 から 9 までの一連の数字。 小数部が存在する場合、整数桁は存在しない可能性があります。
, カルチャ固有の桁区切り記号。 現在のカルチャの桁区切り記号は、 に フラグが含まれている場合stylesNumberStyles.AllowThousands表示できます。
. カルチャ固有の小数点記号。 に フラグが含まれている場合styleは、現在のカルチャの小数点記号を NumberStyles.AllowDecimalPoints表示できます。
小数部の桁数 数値の小数部を指定する 0 から 9 までの一連の数字。 フラグが含まれている場合style、小数部の数字が にsNumberStyles.AllowDecimalPoint表示されます。
e e または E 文字。指数表記を使用して数値を表すことができることを s 示します。 style に フラグが含まれている場合、パラメーターは s 指数表記で数値を NumberStyles.AllowExponent 表すことができます。
exponential-digits 指数を指定する 0 ~ 9 の範囲の一連の数字。

Note

の終端の NUL (U+0000) 文字 s は、引数の style 値に関係なく、解析操作では無視されます。

数字のみの文字列 (スタイルに NumberStyles.None 対応) は、型の Single 範囲内にある場合は常に正常に解析されます。 残りの System.Globalization.NumberStyles メンバーは、入力文字列に存在する必要がない要素を制御します。 次の表は、 にs存在する可能性がある要素に個々NumberStylesのフラグがどのように影響するかを示しています。

NumberStyles 値 数字に加えて、 で許可される要素
None 整数桁の要素のみ。
AllowDecimalPoint および小数部の要素
AllowExponent パラメーターでは s 、指数表記を使用することもできます。 このフラグ自体は、 整数桁E指数桁の形式の値をサポートします。正符号や負符号、小数点記号などの要素を使用して、指数表記で文字列を正常に解析するには、追加のフラグが必要です。
AllowLeadingWhite の先頭sにある ws 要素。
AllowTrailingWhite の末尾sにある ws 要素。
AllowLeadingSign の先頭sにある sign 要素。
AllowTrailingSign の末尾sにある sign 要素。
AllowParentheses 数値を囲むかっこの形式の sign 要素。
AllowThousands 要素
AllowCurrencySymbol $ 要素。
Currency すべて。 パラメーターは s 、指数表記で 16 進数または数値を表すことはできません。
Float の先頭または末尾sにある ws 要素。、 のs先頭にある符号、および 記号。 パラメーターでは s 、指数表記を使用することもできます。
Number wssign、桁区切り記号 (,)、および小数点 (.) 要素。
Any を除く s すべてのスタイルは、16 進数を表すことはできません。

パラメーターはprovider、カルチャ固有のIFormatProviderGetFormat書式設定情報を提供する オブジェクトをNumberFormatInfoメソッドが返す実装です。 メソッドがTryParse(String, NumberStyles, IFormatProvider, Single)呼び出されると、パラメーターの GetFormat メソッドをprovider呼び出し、型をType表すオブジェクトをNumberFormatInfo渡します。 メソッドは GetFormat 、パラメーターの形式に NumberFormatInfo 関する情報を提供する オブジェクトを s 返します。 パラメーターを使用 provider して、解析操作にカスタム書式情報を指定するには、次の 3 つの方法があります。

  • 書式設定情報を CultureInfo 提供するカルチャを表す オブジェクトを渡すことができます。 そのメソッドは GetFormat 、そのカルチャの NumberFormatInfo 数値書式情報を提供する オブジェクトを返します。

  • 数値書式情報を提供する実際 NumberFormatInfo のオブジェクトを渡すことができます。 (の実装 GetFormat は、それ自体を返すだけです)。

  • を実装 IFormatProviderするカスタム オブジェクトを渡すことができます。 そのメソッドは GetFormat 、書式設定情報を提供する オブジェクトを NumberFormatInfo インスタンス化して返します。

が の場合provider、 のs書式設定は、現在のカルチャの NumberFormatInfo オブジェクトに基づいて解釈nullされます。

がデータ型の範囲外のSingle場合s、メソッドは .NET Framework および .NET Core 2.2 以前のバージョンで をスローOverflowExceptionします。 .NET Core 3.0 以降のバージョンでは、 が よりSingle.MinValue小さい場合sは を返しSingle.PositiveInfinity、 が よりSingle.MaxValue大きい場合sは を返Single.NegativeInfinityします。

解析操作中にパラメーターで s 区切り記号が検出され、該当する通貨または数値の小数点とグループ区切り記号が同じである場合、解析操作では、区切り記号がグループ区切り記号ではなく小数点の区切り記号であると見なされます。 区切り記号の詳細については、「、、、および 」を参照してくださいCurrencyDecimalSeparatorCurrencyGroupSeparatorNumberDecimalSeparatorNumberGroupSeparator

こちらもご覧ください

適用対象