Single.TryParse メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
数値の文字列形式を、それと等価な単精度浮動小数点数に変換します。 戻り値は変換が成功したか失敗したかを示します。
オーバーロード
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 仕様で必要に応じて または NegativeInfinity にPositiveInfinity丸められます。 .NET Frameworkを含む以前のバージョンでは、大きすぎる値を解析するとエラーが発生しました。
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
された結果、または失敗した場合に未定義の値が格納されます。
戻り値
true
が正常に解析された場合 s
は 。それ以外の場合 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
パラメーターの値と等価の単精度浮動小数点数を格納します。変換に失敗した場合は 0 を格納します。 s
パラメーターが null
か空の場合、または有効な形式の数値でない場合、変換は失敗します。 が Single.MinValue より小さい有効な数値の場合s
、 result
は ですNegativeInfinity。 が Single.MaxValue より大きい有効な数値の場合s
、 result
は ですPositiveInfinity。 このパラメーターは初期化されていない状態で渡されています。result
で最初に指定された任意の値が上書きされます。
戻り値
s
が正常に変換された場合は true
。それ以外の場合は false
。
注釈
.NET Core 3.0 以降では、表すには大きすぎる値は、IEEE 754 仕様で必要に応じて または NegativeInfinity にPositiveInfinity丸められます。 .NET Frameworkを含む以前のバージョンでは、大きすぎる値を解析するとエラーが発生しました。
適用対象
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
に格納された数値または記号に等しい単精度浮動小数点数を格納します。変換に失敗した場合は 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 仕様で必要に応じて または NegativeInfinity にPositiveInfinity丸められます。 .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場合は をs
返Single.NegativeInfinitys
します。
解析操作中にパラメーターで s
区切り記号が検出され、該当する通貨または数値の小数点とグループの区切り記号が同じ場合、解析操作では、区切り記号がグループ区切り記号ではなく小数点の区切り記号であると見なされます。 区切り記号の詳細については、「、、、および 」を参照してくださいCurrencyDecimalSeparatorCurrencyGroupSeparatorNumberDecimalSeparator。NumberGroupSeparator
こちらもご覧ください
適用対象
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
された結果、または失敗した場合に未定義の値が含まれます。
戻り値
true
が正常に解析された場合 utf8Text
は 。それ以外の場合 false
は 。
適用対象
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
された結果または失敗した場合は未定義の値が格納されます。
戻り値
true
正常に解析された場合 s
は 。それ以外の場合 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
された結果または失敗した場合の未定義の値が含まれます。
戻り値
true
正常に解析された場合 utf8Text
は 。それ以外の場合 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
このメソッドが戻るときに、 には、変換が成功した場合は に含まれる数値または記号に相当する単精度浮動小数点数が格納され、変換に失敗した場合は 0 が格納 utf8Text
されます。 が Empty であるか、有効な形式でない場合utf8Text
、変換は失敗します。 このパラメーターは、初期化されていない状態で渡されます。result にもともと入っていた値は上書きされます。
戻り値
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
に格納された数値または記号に等しい単精度浮動小数点数を格納します。変換に失敗した場合は 0 を格納します。 パラメーターが または である場合、または Emptyが null
に準拠style
している形式でない場合s
、または Single.MinValue より小さい数値または Single.MaxValue より大きい数値を表す場合、またはが列挙定数のNumberStyles有効な組み合わせでない場合style
、変換は失敗します。 このパラメーターは初期化されていない状態で渡されています。result
で最初に指定された任意の値が上書きされます。
戻り値
s
が正常に変換された場合は true
。それ以外の場合は false
。
注釈
.NET Core 3.0 以降では、表すには大きすぎる値は、IEEE 754 仕様で必要に応じて または NegativeInfinity にPositiveInfinity丸められます。 .NET Frameworkを含む以前のバージョンでは、大きすぎる値を解析するとエラーが発生しました。
適用対象
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
に格納された数値または記号に等しい単精度浮動小数点数を格納します。変換に失敗した場合は 0 を格納します。 s
パラメーターが null
または Empty の場合、style
に準拠する形式ではない場合、または style
が NumberStyles 列挙定数の有効な組み合わせでない場合、変換は失敗します。 また、Single.MinValue より小さい数値または Single.MaxValue より大きい数値を表す場合s
は、.NET Frameworkまたは .NET Core 2.2 以前のバージョンでも失敗します。 このパラメーターは初期化されていない状態で渡されています。result
で最初に指定された任意の値が上書きされます。
戻り値
s
が正常に変換された場合は true
。それ以外の場合は false
。
例外
例
次の例では、 メソッドを 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 仕様で必要に応じて または NegativeInfinity にPositiveInfinity丸められます。 .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 は、通貨記号を にs NumberStyles.AllowCurrencySymbol表示できます。 |
sign | 省略可能な記号。 署名は、 フラグを含む場合は のs 先頭に表示され、フラグが含NumberStyles.AllowLeadingSignまれている場合style は のs 末尾にNumberStyles.AllowTrailingSign表示style されます。 に フラグが含まれている場合style は、かっこを使用s して負の値をNumberStyles.AllowParentheses示すことができます。 |
整数桁 | 数値の整数部分を指定する 0 から 9 までの一連の数字。 小数部が存在する場合、整数桁は存在しない可能性があります。 |
, | カルチャ固有の桁区切り記号。 現在のカルチャの桁区切り記号は、 に フラグが含まれている場合style にs NumberStyles.AllowThousands表示できます。 |
. | カルチャ固有の小数点記号。 に フラグが含まれている場合style は、現在のカルチャの小数点記号を NumberStyles.AllowDecimalPoint にs 表示できます。 |
小数部の桁数 | 数値の小数部を指定する 0 から 9 までの一連の数字。 フラグが含まれている場合style 、小数部の数字が にs NumberStyles.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 | 、ws sign 、桁区切り記号 (,)、および小数点 (.) 要素。 |
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
区切り記号が検出され、該当する通貨または数値の小数点とグループ区切り記号が同じである場合、解析操作では、区切り記号がグループ区切り記号ではなく小数点の区切り記号であると見なされます。 区切り記号の詳細については、「、、、および 」を参照してくださいCurrencyDecimalSeparatorCurrencyGroupSeparatorNumberDecimalSeparator。NumberGroupSeparator
こちらもご覧ください
適用対象
.NET
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示