Double.TryParse メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
数値の文字列形式を、等価の倍精度浮動小数点数に変換します。 戻り値は変換が成功したか失敗したかを示します。
オーバーロード
TryParse(ReadOnlySpan<Char>, IFormatProvider, Double) |
文字のスパンを値に解析しようとします。 |
TryParse(ReadOnlySpan<Char>, Double) |
指定したスタイルおよびカルチャ固有の書式による数値のスパン表現を、等価の倍精度浮動小数点数に変換します。 戻り値は変換が成功したか失敗したかを示します。 |
TryParse(String, Double) |
数値の文字列形式を、等価の倍精度浮動小数点数に変換します。 戻り値は変換が成功したか失敗したかを示します。 |
TryParse(ReadOnlySpan<Byte>, IFormatProvider, Double) |
UTF-8 文字のスパンを値に解析しようとします。 |
TryParse(String, 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 仕様で必要に応じて または NegativeInfinity にPositiveInfinity丸められます。 .NET Framework を含む以前のバージョンでは、大きすぎる値を解析するとエラーが発生しました。
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
された結果、または失敗した場合は未定義の値が格納されます。
戻り値
true
正常に解析された場合 s
は 。それ以外の場合 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
パラメーターに含まれている数値または記号と等価の倍精度浮動小数点数が格納されます。変換に失敗した場合は 0 が格納されます。 s
パラメーターが null
または空の場合、または style
に従った形式ではない場合、変換は失敗します。 style
が NumberStyles 列挙定数の有効な組み合わせではない場合も、変換は失敗します。 が Double.MinValue より小さい有効な数値の場合s
、 result
は ですNegativeInfinity。 が Double.MaxValue より大きい有効な数値の場合s
、 result
は ですPositiveInfinity。 このパラメーターは初期化されていない状態で渡されています。result
で最初に指定された任意の値が上書きされます。
戻り値
s
が正常に変換された場合は true
。それ以外の場合は false
。
注釈
.NET Core 3.0 以降では、表すには大きすぎる値は、IEEE 754 仕様で必要に応じて または NegativeInfinity にPositiveInfinity丸められます。 .NET Framework を含む以前のバージョンでは、大きすぎる値を解析するとエラーが発生しました。
適用対象
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
パラメーターの値と等価の倍精度浮動小数点数を格納します。変換に失敗した場合は 0 を格納します。 s
パラメーターが null
または Empty の場合、または有効な形式の数値でない場合、変換は失敗します。 また、Double.MinValue より小さい数値または Double.MaxValue より大きい数値を表す場合s
は、.NET Framework および .NET Core 2.2 以前のバージョンでも失敗します。 このパラメーターは初期化されていない状態で渡されています。result
で最初に指定された任意の値が上書きされます。
戻り値
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'.
注釈
.NET Core 3.0 以降では、表すには大きすぎる値は、IEEE 754 仕様で必要に応じて または NegativeInfinity にPositiveInfinity丸められます。 .NET Framework を含む以前のバージョンでは、大きすぎる値を解析するとエラーが発生しました。
このオーバーロードは、解析された数値を Double.Parse(String) 返す代わりに解析操作が成功したかどうかを示すブール値を返すことで、メソッドとは異なります。 無効であり、正常に解析できないイベントs
で 例外処理を使用して をテストFormatExceptionする必要がなくなります。
パラメーターにはs
、現在のカルチャの NumberFormatInfo.PositiveInfinitySymbol、、 NumberFormatInfo.NegativeInfinitySymbolNumberFormatInfo.NaNSymbol (文字列比較では大文字と小文字が区別されます)、または形式の文字列を含めることができます。
[ws][sign][整数桁,]整数桁[.[fractional-digits]][e[sign]exponential-digits][ws]
角かっこ内の要素は省略可能です。 次の表は、それぞれの要素の説明です。
要素 | 説明 |
---|---|
ws | 一連の空白文字。 |
sign | 負符号または正符号記号。 |
整数桁 | 数値の整数部分を指定する 0 から 9 までの一連の数値。 小数部が存在する場合、整数桁は存在しない可能性があります。 |
, | カルチャ固有のグループ区切り記号。 |
. | カルチャ固有の小数点記号。 |
小数部の桁数 | 数値の小数部を指定する 0 から 9 までの一連の数値。 |
E | 指数 (指数) 表記を示す大文字または小文字の 'e'。 |
exponential-digits | 指数を指定する 0 ~ 9 の範囲の一連の数値。 |
数値書式の詳細については、「 型の書式設定」を参照してください。
パラメーターはs
、 フラグと NumberStyles.AllowThousands フラグのNumberStyles.Float組み合わせを使用して解釈されます。 つまり、空白と桁区切り記号は使用できますが、通貨記号は使用できません。 に存在できる要素 (通貨記号、桁区切り記号、空白など) を明示的に s
定義するには、 メソッドのオーバーロードを Double.TryParse(String, NumberStyles, IFormatProvider, Double) 使用します。
パラメーターは s
、現在のシステム カルチャ用に初期化された オブジェクトの NumberFormatInfo 書式設定情報を使用して解析されます。 詳細については、「NumberFormatInfo.CurrentInfo」を参照してください。 他の指定されたカルチャの書式設定情報を使用して文字列を解析するには、 メソッドオーバーロードを Double.TryParse(String, NumberStyles, IFormatProvider, Double) 使用します。
通常、メソッドを Double.TryParse 呼び出して作成された文字列をメソッドに Double.ToString 渡すと、元 Double の値が返されます。 ただし、精度が失われるため、値が等しくない可能性があります。 さらに、 または Double.MaxValue のいずれかのDouble.MinValue文字列表現を解析しようとすると、ラウンド トリップに失敗します。 .NET Framework と .NET Core 2.2 以前のバージョンでは、 が OverflowExceptionスローされます。 .NET Core 3.0 以降のバージョンでは、 を解析しようとした場合、または Double.PositiveInfinity を解析MinValueしようとすると MaxValueが返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 以前のバージョンでは、 がデータ型の範囲外のDouble場合s
、 TryParse(String, Double) メソッドは をOverflowExceptionスローします。
.NET Core 3.0 以降のバージョンでは、 がデータ型の範囲外Doubleの場合s
、例外はスローされません。 ほとんどの場合、 メソッドは TryParse(String, Double) または Double.NegativeInfinityのDouble.PositiveInfinity結果を計算します。 ただし、正または負の無限大よりも の最大値または最小値に近いと見なされる値の Double 小さなセットがあります。 このような場合、 メソッドは または Double.MinValueのDouble.MaxValue結果を計算します。
解析操作中にパラメーターで s
区切り記号が検出され、小数点とグループの区切り記号が同じである場合、解析操作では、区切り記号がグループ区切り記号ではなく小数点であると見なされます。 区切り記号の詳細については、「、、、および 」を参照してくださいCurrencyDecimalSeparatorCurrencyGroupSeparatorNumberDecimalSeparator。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
された結果、または失敗した場合に未定義の値が含まれます。
戻り値
true
が正常に解析された場合 utf8Text
は 。それ以外の場合 false
は 。
適用対象
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
された結果または失敗した場合に未定義の値が含まれます。
戻り値
true
が正常に解析された場合 s
は 。それ以外の場合 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
された結果、または失敗した場合に未定義の値が含まれます。
戻り値
true
が正常に解析された場合 utf8Text
は 。それ以外の場合 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
このメソッドが戻るとき、 には、変換が成功した場合は に含まれる数値または記号と等価の倍精度浮動小数点数が含まれます。変換に失敗した場合は 0 が格納 utf8Text
されます。 が Empty または が有効な形式でない場合utf8Text
、変換は失敗します。 このパラメーターは、初期化されていない状態で渡されます。result にもともと入っていた値は上書きされます。
戻り値
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
に格納された数値または記号と等価の倍精度浮動小数点数が格納されます。 変換に失敗した場合は、0 が格納されます。 s
パラメーターが、null
、空の文字スパン、または style
に従った書式の数値ではない場合、変換は失敗します。 が Double.MinValue より小さい有効な数値の場合s
、 result
は ですNegativeInfinity。 が Double.MaxValue より大きい有効な数値の場合s
、 result
は ですPositiveInfinity。 このパラメーターは初期化されていない状態で渡されています。result
で最初に指定された任意の値が上書きされます。
戻り値
s
が正常に変換された場合は true
。それ以外の場合は false
。
注釈
.NET Core 3.0 以降では、表すには大きすぎる値は、IEEE 754 仕様で必要に応じて または NegativeInfinity にPositiveInfinity丸められます。 .NET Framework を含む以前のバージョンでは、大きすぎる値を解析するとエラーが発生しました。
適用対象
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
s
に関するカルチャに固有の書式設定情報を提供する IFormatProvider。
- result
- Double
変換が成功した場合、このメソッドから戻るときに、s
に格納された数値または記号と等価の倍精度浮動小数点数を格納します。変換に失敗した場合は 0 を格納します。 s
パラメーターが null
または Empty の場合、style
に準拠する形式ではない場合、または style
が NumberStyles 列挙定数の有効な組み合わせでない場合、変換は失敗します。 SByte.MinValue より小さい数値または SByte.MaxValue より大きい値を表す場合s
は、.NET Framework または .NET Core 2.2 以前のバージョンでも失敗します。 このパラメーターは初期化されていない状態で渡されています。result
で最初に指定された任意の値が上書きされます。
戻り値
s
が正常に変換された場合は true
。それ以外の場合は false
。
例外
例
次の例では、 メソッドを 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'.
注釈
.NET Core 3.0 以降では、表すには大きすぎる値は、IEEE 754 仕様で必要に応じて または NegativeInfinity にPositiveInfinity丸められます。 .NET Framework を含む以前のバージョンでは、大きすぎる値を解析するとエラーが発生しました。
メソッドは TryParse メソッドに Parse(String, NumberStyles, IFormatProvider) 似ていますが、変換が失敗した場合、このメソッドは例外をスローしません。 変換が成功した場合、戻り値は であり true
、 result
パラメーターは変換の結果に設定されます。 変換が失敗した場合、戻り値は であり false
、 result
パラメーターは 0 に設定されます。 これにより、例外処理を使用して、 が無効で正常に解析できないイベントs
で をテストFormatExceptionする必要がなくなります。
パラメーターは style
、解析操作を成功させるためにパラメーターの s
許容される形式を定義します。 列挙からのビット フラグ NumberStyles の組み合わせである必要があります。 次 NumberStyles のメンバーはサポートされていません。
パラメーターにはs
、 でprovider
示されるカルチャの 、NumberFormatInfo.NegativeInfinitySymbol、または NumberFormatInfo.NaNSymbol を含NumberFormatInfo.PositiveInfinitySymbolめることができます。 さらに、 の値 style
によっては、 パラメーターに s
次の要素が含まれる場合があります。
[ws][$][sign][整数桁,]整数桁[.fractional-digits][e[sign]exponential-digits][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 にNumberStyles.AllowThousandsにs 表示できます。 |
. | カルチャ固有の小数点記号。 現在のカルチャの小数点記号は、 フラグが含まれている場合style にNumberStyles.AllowDecimalPoints に表示できます。 |
小数部の数字 | 数値の小数部を指定する 0 から 9 までの一連の数字。 フラグが含まれている場合style 、小数部の数字を にs NumberStyles.AllowDecimalPoint表示できます。 |
e | e または E 文字。指数表記を使用して数値を表すことができることを s 示します。 style に フラグが含まれている場合、パラメーターは s 指数表記で数値を NumberStyles.AllowExponent 表すことができます。 |
exponential-digits | 指数を指定する 0 から 9 までの一連の数字。 |
注意
の終端 NUL (U+0000) 文字 s
は、引数の style
値に関係なく、解析操作では無視されます。
数字のみを含む文字列 (スタイルに NumberStyles.None 対応) は、型の Double 範囲内にある場合は常に正常に解析されます。 残りの 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
、 IFormatProvider オブジェクトや CultureInfo オブジェクトなどのNumberFormatInfo実装です。 パラメーターは provider
、解析で使用されるカルチャ固有の情報を提供します。 が null
または オブジェクトをNumberFormatInfo取得できない場合provider
は、現在のカルチャの書式情報が使用されます。
パラメーターがs
null
数値であるか、パラメーターがオブジェクトをprovider
生成NumberFormatInfoしないか、またはstyle
パラメーターが列挙型のビット フラグNumberStylesの組み合わせでない場合、変換は失敗します。
通常、メソッドを Double.TryParse 呼び出して作成された文字列をメソッドに Double.ToString 渡すと、元 Double の値が返されます。 ただし、精度が失われるため、値が等しくない可能性があります。 さらに、 または Double.MaxValue のいずれかのDouble.MinValue文字列表現を解析しようとすると、ラウンド トリップに失敗します。 .NET Framework と .NET Core 2.2 以前のバージョンでは、 が OverflowExceptionスローされます。 .NET Core 3.0 以降のバージョンでは、 を解析しようとした場合、または Double.PositiveInfinity を解析MinValueしようとすると MaxValueが返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 以前のバージョンでは、 がデータ型の範囲外のDouble場合s
、 Double.TryParse(String, NumberStyles, IFormatProvider, Double) メソッドは をOverflowExceptionスローします。
.NET Core 3.0 以降のバージョンでは、 がデータ型の範囲外Doubleの場合s
、例外はスローされません。 ほとんどの場合、 メソッドは Double.TryParse(String, NumberStyles, IFormatProvider, Double) または Double.NegativeInfinityのDouble.PositiveInfinity結果を計算します。 ただし、正または負の無限大よりも の最大値または最小値に近いと見なされる値の Double 小さなセットがあります。 このような場合、 メソッドは または Double.MinValueのDouble.MaxValue結果を計算します。
解析操作中にパラメーターで s
区切り記号が検出され、該当する通貨または数値の小数点とグループ区切り記号が同じである場合、解析操作では、区切り記号がグループ区切り記号ではなく小数点の区切り記号であると見なされます。 区切り記号の詳細については、「、、、および 」を参照してくださいCurrencyDecimalSeparatorCurrencyGroupSeparatorNumberDecimalSeparator。NumberGroupSeparator
こちらもご覧ください
適用対象
.NET
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示