Double.TryParse メソッド

定義

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

オーバーロード

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

TryParse(ReadOnlySpan<Char>, IFormatProvider, Double)

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

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)

指定したスタイルおよびカルチャ固有の書式による数値のスパン表現を、等価の倍精度浮動小数点数に変換します。 戻り値は変換が成功したか失敗したかを示します。

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 に従った形式ではない場合、変換は失敗します。 styleNumberStyles 列挙定数の有効な組み合わせではない場合も、変換は失敗します。 が Double.MinValue より小さい有効な数値の場合sresult は ですNegativeInfinity。 が Double.MaxValue より大きい有効な数値の場合sresult は ですPositiveInfinity。 このパラメーターは初期化されていない状態で渡されています。result で最初に指定された任意の値が上書きされます。

戻り値

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

注釈

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

適用対象

TryParse(String, Double)

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

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 仕様で必要に応じて または NegativeInfinityPositiveInfinity丸められます。 .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場合sTryParse(String, Double) メソッドは をOverflowExceptionスローします。

.NET Core 3.0 以降のバージョンでは、 がデータ型の範囲外Doubleの場合s、例外はスローされません。 ほとんどの場合、 メソッドは TryParse(String, Double) または Double.NegativeInfinityDouble.PositiveInfinity結果を計算します。 ただし、正または負の無限大よりも の最大値または最小値に近いと見なされる値の Double 小さなセットがあります。 このような場合、 メソッドは または Double.MinValueDouble.MaxValue結果を計算します。

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

こちらもご覧ください

適用対象

TryParse(ReadOnlySpan<Byte>, IFormatProvider, Double)

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)

文字列を値に解析しようとします。

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)

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)

数値の文字列表現を含む 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)

指定したスタイルおよびカルチャ固有の書式による数値の文字列表現を含む文字スパンを、等価の倍精度浮動小数点数に変換します。 戻り値は変換が成功したか失敗したかを示します。

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 より小さい有効な数値の場合sresult は ですNegativeInfinity。 が Double.MaxValue より大きい有効な数値の場合sresult は ですPositiveInfinity。 このパラメーターは初期化されていない状態で渡されています。result で最初に指定された任意の値が上書きされます。

戻り値

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

注釈

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

適用対象

TryParse(String, NumberStyles, IFormatProvider, Double)

指定したスタイルおよびカルチャ固有の書式での数値の文字列形式を、等価の倍精度浮動小数点数に変換します。 戻り値は変換が成功したか失敗したかを示します。

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

戻り値

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

例外

styleNumberStyles 値ではありません。

または

style には値 AllowHexSpecifier が含まれています。

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

メソッドは TryParse メソッドに Parse(String, NumberStyles, IFormatProvider) 似ていますが、このメソッドは変換に失敗した場合に例外をスローしません。 変換が成功した場合、戻り値は で trueresult パラメーターは変換の結果に設定されます。 変換が失敗した場合、戻り値は であり falseresult パラメーターは 0 に設定されます。 これにより、例外処理を使用して、 が無効で正常に解析できないイベントsで をテストFormatExceptionする必要がなくなります。

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

パラメーターにはs、 でprovider示されるカルチャの 、NumberFormatInfo.NegativeInfinitySymbol、または NumberFormatInfo.NaNSymbol を含NumberFormatInfo.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 対応) は、型の Double 範囲内にある場合は常に正常に解析されます。 残りの System.Globalization.NumberStyles メンバーは、入力文字列に存在する必要がない要素を制御します。 次の表は、個々 NumberStyles のフラグが に s存在する可能性がある要素に与える影響を示しています。

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

パラメーターはproviderIFormatProviderCultureInfo オブジェクトなどのNumberFormatInfo実装です。 パラメーターは provider 、解析で使用されるカルチャ固有の情報を提供します。 が null または オブジェクトをNumberFormatInfo取得できない場合providerは、現在のカルチャの書式情報が使用されます。

パラメーターが数値であるか、パラメーターnullがオブジェクトをprovider生成NumberFormatInfoしないか、またはパラメーターがstyle列挙からのビット フラグNumberStylesの組み合わせでない場合s、変換は失敗します。

通常、 メソッドを Double.TryParse 呼び出して作成された文字列をメソッドに Double.ToString 渡すと、元 Double の値が返されます。 ただし、精度が失われるため、値が等しくない可能性があります。 さらに、 または のいずれかのDouble.MinValueDouble.MaxValue文字列表現を解析しようとすると、ラウンド トリップに失敗します。 .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場合sDouble.TryParse(String, NumberStyles, IFormatProvider, Double) メソッドは をOverflowExceptionスローします。

.NET Core 3.0 以降のバージョンでは、 がデータ型の範囲外Doubleである場合s、例外はスローされません。 ほとんどの場合、 メソッドは Double.TryParse(String, NumberStyles, IFormatProvider, Double) または Double.NegativeInfinityDouble.PositiveInfinity結果を計算します。 ただし、正または負の無限大よりも、 の最大値または最小値に近いと見なされる値の Double 小さなセットがあります。 このような場合、メソッドは または Double.MinValueDouble.MaxValue結果を計算します。

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

こちらもご覧ください

適用対象