Decimal.Parse メソッド

定義

数値の文字列形式を、それと等価の Decimal に変換します。

オーバーロード

Parse(String, NumberStyles, IFormatProvider)

指定したスタイルとカルチャ固有の書式を使用して、文字列形式の数値をそれと等価の Decimal に変換します。

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

指定したスタイルとカルチャ固有の書式を使用して、数値のスパン表現を等価の Decimal に変換します。

Parse(String, IFormatProvider)

指定したカルチャ固有の書式情報を使用して、文字列形式の数値をそれと等価の Decimal に変換します。

Parse(String, NumberStyles)

指定のスタイルで表現された数値の文字列形式を、それと等価な Decimal に変換します。

Parse(String)

数値の文字列形式を、それと等価の Decimal に変換します。

Parse(String, NumberStyles, IFormatProvider)

指定したスタイルとカルチャ固有の書式を使用して、文字列形式の数値をそれと等価の Decimal に変換します。

public:
 static System::Decimal Parse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider);
public static decimal Parse (string s, System.Globalization.NumberStyles style, IFormatProvider provider);
public static decimal Parse (string s, System.Globalization.NumberStyles style, IFormatProvider? provider);
static member Parse : string * System.Globalization.NumberStyles * IFormatProvider -> decimal
Public Shared Function Parse (s As String, style As NumberStyles, provider As IFormatProvider) As Decimal

パラメーター

s
String

変換する数値の文字列形式。

style
NumberStyles

s で使用可能なスタイル要素を示す、NumberStyles 値のビットごとの組み合わせ。 通常指定する値は、Number です。

provider
IFormatProvider

s の書式設定に関するカルチャ固有の情報を提供する IFormatProvider オブジェクト。

戻り値

Decimal

Decimals に指定されたとおり、style に格納されている数値と等価の provider 数値。

例外

s が正しい形式ではありません。

s は、MinValue 未満の数値か、MaxValue より大きい数値を表します。

snullです。

styleNumberStyles 値ではありません。

または

styleAllowHexSpecifier 値です。

次の例では、さまざまなパラメーターを使用して、 style provider 値の文字列形式を解析し Decimal ます。

string value;
decimal number;
NumberStyles style;
CultureInfo provider;

// Parse string using " " as the thousands separator
// and "," as the decimal separator for fr-FR culture.
value = "892 694,12";
style = NumberStyles.AllowDecimalPoint | NumberStyles.AllowThousands;
provider = new CultureInfo("fr-FR");

number = Decimal.Parse(value, style, provider);
Console.WriteLine("'{0}' converted to {1}.", value, number);
// Displays:
//    '892 694,12' converted to 892694.12.

try
{
   number = Decimal.Parse(value, style, CultureInfo.InvariantCulture);
   Console.WriteLine("'{0}' converted to {1}.", value, number);
}
catch (FormatException)
{
   Console.WriteLine("Unable to parse '{0}'.", value);
}
// Displays:
//    Unable to parse '892 694,12'.

// Parse string using "$" as the currency symbol for en-GB and
// en-US cultures.
value = "$6,032.51";
style = NumberStyles.Number | NumberStyles.AllowCurrencySymbol;
provider = new CultureInfo("en-GB");

try
{
   number = Decimal.Parse(value, style, provider);
   Console.WriteLine("'{0}' converted to {1}.", value, number);
}
catch (FormatException)
{
   Console.WriteLine("Unable to parse '{0}'.", value);
}
// Displays:
//    Unable to parse '$6,032.51'.

provider = new CultureInfo("en-US");
number = Decimal.Parse(value, style, provider);
Console.WriteLine("'{0}' converted to {1}.", value, number);
// Displays:
//    '$6,032.51' converted to 6032.51.
Dim value As String
Dim number As Decimal
Dim style As NumberStyles
Dim provider As CultureInfo

' Parse string using " " as the thousands separator 
' and "," as the decimal separator for fr-FR culture.
value = "892 694,12"
style = NumberStyles.AllowDecimalPoint Or NumberStyles.AllowThousands
provider = New CultureInfo("fr-FR")

number = Decimal.Parse(value, style, provider)  
Console.WriteLine("'{0}' converted to {1}.", value, number)
' Displays: 
'    '892 694,12' converted to 892694.12.

Try
   number = Decimal.Parse(value, style, CultureInfo.InvariantCulture)  
   Console.WriteLine("'{0}' converted to {1}.", value, number)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", value)
End Try
' Displays: 
'    Unable to parse '892 694,12'.  

' Parse string using "$" as the currency symbol for en-GB and
' en-US cultures.
value = "$6,032.51"
style = NumberStyles.Number Or NumberStyles.AllowCurrencySymbol
provider = New CultureInfo("en-GB")

Try
   number = Decimal.Parse(value, style, provider)  
   Console.WriteLine("'{0}' converted to {1}.", value, number)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", value)
End Try
' Displays: 
'    Unable to parse '$6,032.51'.

provider = New CultureInfo("en-US")
number = Decimal.Parse(value, style, provider)  
Console.WriteLine("'{0}' converted to {1}.", value, number)
' Displays: 
'    '$6,032.51' converted to 6032.51.

注釈

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

の値によっては、 パラメーターに style s 次の要素が含まれる場合があります。

[ws][$][sign][digits,]digits[.fractional-digits][e[sign]digits][ws]

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

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

注意

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

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

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

パラメーター provider は、 IFormatProvider オブジェクトや オブジェクトなどの NumberFormatInfo 実装 CultureInfo です。 パラメーターは、 provider 解析に使用されるカルチャ固有の情報を提供します。 providernull の場合は、スレッドの現在のカルチャが使用されます。

Decimalオブジェクトの有効桁数は29桁です。 が s 29 桁を超える数値を表していて、小数部を持ち、かつの範囲内にある場合、数値は切り捨てられず、切り捨てられずに、 MaxValue MinValue 近似値に丸められて29桁に丸められます。

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

こちらもご覧ください

適用対象

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

指定したスタイルとカルチャ固有の書式を使用して、数値のスパン表現を等価の Decimal に変換します。

public static decimal Parse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.Number, IFormatProvider? provider = default);
public static decimal Parse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.Number, IFormatProvider provider = default);
static member Parse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider -> decimal
Public Shared Function Parse (s As ReadOnlySpan(Of Char), Optional style As NumberStyles = System.Globalization.NumberStyles.Number, Optional provider As IFormatProvider = Nothing) As Decimal

パラメーター

s
ReadOnlySpan<Char>

変換する数値を表す文字を格納しているスパン。

style
NumberStyles

s で使用可能なスタイル要素を示す、NumberStyles 値のビットごとの組み合わせ。 通常指定する値は、Number です。

provider
IFormatProvider

s の書式設定に関するカルチャ固有の情報を提供する IFormatProvider オブジェクト。

戻り値

Decimal

Decimals に指定されたとおり、style に格納されている数値と等価の provider 数値。

適用対象

Parse(String, IFormatProvider)

指定したカルチャ固有の書式情報を使用して、文字列形式の数値をそれと等価の Decimal に変換します。

public:
 static System::Decimal Parse(System::String ^ s, IFormatProvider ^ provider);
public static decimal Parse (string s, IFormatProvider provider);
public static decimal Parse (string s, IFormatProvider? provider);
static member Parse : string * IFormatProvider -> decimal
Public Shared Function Parse (s As String, provider As IFormatProvider) As Decimal

パラメーター

s
String

変換する数値の文字列形式。

provider
IFormatProvider

s に関するカルチャに固有の解析情報を提供する IFormatProvider

戻り値

Decimal

Decimal で指定されたとおりの s に格納されている数値と等価の provider 数値。

例外

snullです。

s が正しい形式ではありません。

s は、MinValue 未満の数値か、MaxValue より大きい数値を表します。

次の例は、Web フォームのボタン クリック イベント ハンドラーです。 プロパティによって返される配列を使用 HttpRequest.UserLanguages して、ユーザーのロケールを決定します。 その後、そのロケール CultureInfo に対応する オブジェクトをインスタンス化します。 そのオブジェクトに属する オブジェクトは、ユーザーの入力を値に変換するために メソッド NumberFormatInfo CultureInfo Parse(String, IFormatProvider) に渡 Decimal されます。

protected void OkToDecimal_Click(object sender, EventArgs e)
{
   string locale;
   decimal number;
   CultureInfo culture;

   // Return if string is empty
   if (String.IsNullOrEmpty(this.inputNumber.Text))
      return;

   // Get locale of web request to determine possible format of number
   if (Request.UserLanguages.Length == 0)
      return;
   locale = Request.UserLanguages[0];
   if (String.IsNullOrEmpty(locale))
      return;

  // Instantiate CultureInfo object for the user's locale
   culture = new CultureInfo(locale);

   // Convert user input from a string to a number
   try
   {
      number = Decimal.Parse(this.inputNumber.Text, culture.NumberFormat);
   }
   catch (FormatException)
   {
      return;
   }
   catch (Exception)
   {
      return;
   }
   // Output number to label on web form
   this.outputNumber.Text = "Number is " + number.ToString();
}
Protected Sub OkToDecimal_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles OkToDecimal.Click
   Dim locale As String
   Dim culture As CultureInfo
   Dim number As Decimal

   ' Return if string is empty
   If String.IsNullOrEmpty(Me.inputNumber.Text) Then Exit Sub

   ' Get locale of web request to determine possible format of number
   If Request.UserLanguages.Length = 0 Then Exit Sub
   locale = Request.UserLanguages(0)
   If String.IsNullOrEmpty(locale) Then Exit Sub

   ' Instantiate CultureInfo object for the user's locale
   culture = New CultureInfo(locale)

   ' Convert user input from a string to a number
   Try
      number = Decimal.Parse(Me.inputNumber.Text, culture.NumberFormat)
   Catch ex As FormatException
      Exit Sub
   Catch ex As Exception
      Exit Sub
   End Try

   ' Output number to label on web form
   Me.outputNumber.Text = "Number is " & number.ToString()
End Sub

注釈

このメソッドのオーバーロード Parse(String, IFormatProvider) は、さまざまな方法で書式設定できるテキストを値に変換するためによく使用され Decimal ます。 たとえば、ユーザーが入力したテキストを HTML テキストボックスに数値に変換するために使用できます。

パラメーターには、 s 次のような形式の数値が含まれています。

jax-wsシャープ[数字,] 数字 [. 小数部の桁] [ws]

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

要素 説明
ws 省略可能な空白。
sign 省略可能な記号。
数値 0 ~ 9 の範囲の数字のシーケンス。
, カルチャ固有の桁区切り記号。
. カルチャ固有の小数点記号。
小数部の数字 0 ~ 9 の範囲の数字のシーケンス。

パラメーター s は、 スタイルを使用して解釈 NumberStyles.Number されます。 つまり、空白と桁区切り記号は使用できますが、通貨記号は許可されません。 に存在できる要素 (通貨記号、桁区切り記号、空白など) を明示的に定義するには、 メソッド s を使用 Decimal.Parse(String, NumberStyles, IFormatProvider) します。

パラメーター provider は、 IFormatProvider オブジェクトや オブジェクトなどの NumberFormatInfo 実装 CultureInfo です。 パラメーター provider は、解析で使用されるカルチャ固有の情報を提供します。 providernull の場合は、スレッドの現在のカルチャが使用されます。

オブジェクト Decimal の有効桁数は 29 桁です。 が 29 桁を超える数値を表すが、小数部を持ち、 が および の範囲内にある場合、数値は丸め処理を使用して、切り捨てではなく s MaxValue MinValue 29 桁に丸められます。

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

こちらもご覧ください

適用対象

Parse(String, NumberStyles)

指定のスタイルで表現された数値の文字列形式を、それと等価な Decimal に変換します。

public:
 static System::Decimal Parse(System::String ^ s, System::Globalization::NumberStyles style);
public static decimal Parse (string s, System.Globalization.NumberStyles style);
static member Parse : string * System.Globalization.NumberStyles -> decimal
Public Shared Function Parse (s As String, style As NumberStyles) As Decimal

パラメーター

s
String

変換する数値の文字列形式。

style
NumberStyles

s で使用可能なスタイル要素を示す、NumberStyles 値のビットごとの組み合わせ。 通常指定する値は、Number です。

戻り値

Decimal

Decimal で指定されたとおりの s に格納されている数値と等価の style 数値。

例外

snullです。

styleNumberStyles 値ではありません。

または

styleAllowHexSpecifier 値です。

s が正しい形式ではありません。

s は、MinValue 未満の数値か、MaxValue より大きい数値を表します。

次のコード例では、メソッドを使用し Parse(String, NumberStyles) て、 Decimal en-us カルチャを使用して値の文字列形式を解析します。

string value;
decimal number;
NumberStyles style;

// Parse string with a floating point value using NumberStyles.None.
value = "8694.12";
style = NumberStyles.None;
try
{
   number = Decimal.Parse(value, style);
   Console.WriteLine("'{0}' converted to {1}.", value, number);
}
catch (FormatException)
{
   Console.WriteLine("Unable to parse '{0}'.", value);
}
// Displays:
//    Unable to parse '8694.12'.

// Parse string with a floating point value and allow decimal point.
style = NumberStyles.AllowDecimalPoint;
number = Decimal.Parse(value, style);
Console.WriteLine("'{0}' converted to {1}.", value, number);
// Displays:
//    '8694.12' converted to 8694.12.

// Parse string with negative value in parentheses
value = "(1,789.34)";
style = NumberStyles.AllowDecimalPoint | NumberStyles.AllowThousands |
        NumberStyles.AllowParentheses;
number = Decimal.Parse(value, style);
Console.WriteLine("'{0}' converted to {1}.", value, number);
// Displays:
//    '(1,789.34)' converted to -1789.34.

// Parse string using Number style
value = " -17,623.49 ";
style = NumberStyles.Number;
number = Decimal.Parse(value, style);
Console.WriteLine("'{0}' converted to {1}.", value, number);
// Displays:
//    ' -17,623.49 ' converted to -17623.49.
Dim value As String
Dim number As Decimal
Dim style As NumberStyles

' Parse string with a floating point value using NumberStyles.None. 
value = "8694.12"
style = NumberStyles.None
Try
   number = Decimal.Parse(value, style)  
   Console.WriteLine("'{0}' converted to {1}.", value, number)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", value)
End Try
' Displays:
'    Unable to parse '8694.12'.

' Parse string with a floating point value and allow decimal point. 
style = NumberStyles.AllowDecimalPoint
number = Decimal.Parse(value, style)  
Console.WriteLine("'{0}' converted to {1}.", value, number)
' Displays:
'    '8694.12' converted to 8694.12.

' Parse string with negative value in parentheses
value = "(1,789.34)"
style = NumberStyles.AllowDecimalPoint Or NumberStyles.AllowThousands Or _
        NumberStyles.AllowParentheses 
number = Decimal.Parse(value, style)  
Console.WriteLine("'{0}' converted to {1}.", value, number)
' Displays:
'    '(1,789.34)' converted to -1789.34.

' Parse string using Number style
value = " -17,623.49 "
style = NumberStyles.Number
number = Decimal.Parse(value, style)  
Console.WriteLine("'{0}' converted to {1}.", value, number)
' Displays:
'    ' -17,623.49 ' converted to -17623.49.

注釈

styleパラメーターでは、解析操作を成功させるためにパラメーターで使用できるスタイル要素 (桁区切り記号、空白、通貨記号など) を定義し s ます。 列挙体のビットフラグの組み合わせである必要があり NumberStyles ます。 次の NumberStyles メンバーはサポートされていません。

の値に応じて style 、パラメーターには s 次の要素を含めることができます。

jax-ws[$]シャープ[数字,] 数字 [. 小数部の桁] [e [符号] 数字] [ws]

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

要素 説明
ws 省略可能な空白。 がフラグを含む場合は、の先頭に空白が表示され s style ます。また、にフラグが含まれている場合は、 NumberStyles.AllowLeadingWhite の末尾に空白文字を含めることができ s style NumberStyles.AllowTrailingWhite ます。
$ カルチャ固有の通貨記号。 文字列内での位置は、現在の NumberFormatInfo.CurrencyNegativePattern カルチャのプロパティとプロパティによって定義され NumberFormatInfo.CurrencyPositivePattern ます。 に s フラグが含まれている場合は、現在のカルチャの通貨記号がに表示され style NumberStyles.AllowCurrencySymbol ます。
sign 省略可能な符号。 にフラグが含まれている場合は、の先頭に符号が表示され s style ます。また、にフラグが含まれている場合は、 NumberStyles.AllowLeadingSign の末尾にも表示され s style NumberStyles.AllowTrailingSign ます。 に s フラグが含まれている場合は、かっこを使用して負の値を示すことができ style NumberStyles.AllowParentheses ます。
数値 0から9までの一連の数字。
, カルチャ固有の桁区切り記号。 に s フラグが含まれている場合、現在のカルチャの桁区切り記号がに表示され style NumberStyles.AllowThousands ます。
. カルチャ固有の小数点の記号。 に s フラグが含まれている場合、現在のカルチャの小数点の記号がに表示され style NumberStyles.AllowDecimalPoint ます。
小数点以下桁数 0から9までの一連の数字。 にフラグが含まれている場合にのみ、に小数点以下の桁数が表示され s style NumberStyles.AllowDecimalPoint ます。
e "E" または "E" 文字。値が指数表記で表されることを示します。 に s フラグが含まれている場合、パラメーターは指数表記で数値を表すことができ style NumberStyles.AllowExponent ます。

注意

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

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

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

sパラメーターは、 NumberFormatInfo 現在のシステムカルチャに対して初期化されたオブジェクトの書式情報を使用して解析されます。 詳細については、「CurrentInfo」を参照してください。

Decimal 有効桁数は29桁です。 が s 29 桁を超える数値を表していて、小数部を持ち、かつの範囲内にある場合、数値は切り捨てられず、切り捨てられずに、 MaxValue MinValue 近似値に丸められて29桁に丸められます。

解析操作中にパラメーターで区切り記号が検出された場合 s 、には styles との値が含まれ、該当する通貨または数値の10進数と桁区切り記号は同じであるため、解析操作では、区切り記号が桁区切り記号では NumberStyles.AllowThousands NumberStyles.AllowDecimalPoint なく小数点であると見なされます。 区切り記号の詳細については、「」、「」、「」、および「」を参照してください CurrencyDecimalSeparator NumberDecimalSeparator CurrencyGroupSeparator NumberGroupSeparator

こちらもご覧ください

適用対象

Parse(String)

数値の文字列形式を、それと等価の Decimal に変換します。

public:
 static System::Decimal Parse(System::String ^ s);
public static decimal Parse (string s);
static member Parse : string -> decimal
Public Shared Function Parse (s As String) As Decimal

パラメーター

s
String

変換する数値の文字列形式。

戻り値

Decimal

s に含まれている数値と等価。

例外

snullです。

s が正しい形式ではありません。

s は、MinValue 未満の数値か、MaxValue より大きい数値を表します。

次のコード例では、メソッドを使用して、 Parse(String) 値の文字列形式を解析し Decimal ます。

string value;
decimal number;
// Parse an integer with thousands separators.
value = "16,523,421";
number = Decimal.Parse(value);
Console.WriteLine("'{0}' converted to {1}.", value, number);
// Displays:
//    '16,523,421' converted to 16523421.

// Parse a floating point value with thousands separators
value = "25,162.1378";
number = Decimal.Parse(value);
Console.WriteLine("'{0}' converted to {1}.", value, number);
// Displays:
//    '25,162.1378' converted to 25162.1378.

// Parse a floating point number with US currency symbol.
value = "$16,321,421.75";
try
{
   number = Decimal.Parse(value);
   Console.WriteLine("'{0}' converted to {1}.", value, number);
}
catch (FormatException)
{
   Console.WriteLine("Unable to parse '{0}'.", value);
}
// Displays:
//    Unable to parse '$16,321,421.75'.

// Parse a number in exponential notation
value = "1.62345e-02";
try
{
   number = Decimal.Parse(value);
   Console.WriteLine("'{0}' converted to {1}.", value, number);
}
catch (FormatException)
{
   Console.WriteLine("Unable to parse '{0}'.", value);
}
// Displays:
//    Unable to parse '1.62345e-02'.
Dim value As String
Dim number As Decimal

' Parse an integer with thousands separators. 
value = "16,523,421"
number = Decimal.Parse(value)
Console.WriteLine("'{0}' converted to {1}.", value, number)
' Displays: 
'    '16,523,421' converted to 16523421.

' Parse a floating point value with thousands separators
value = "25,162.1378"
number = Decimal.Parse(value)
Console.WriteLine("'{0}' converted to {1}.", value, number)
' Displays:
'    '25,162.1378' converted to 25162.1378.

' Parse a floating point number with US currency symbol.
value = "$16,321,421.75"
Try
   number = Decimal.Parse(value)
   Console.WriteLine("'{0}' converted to {1}.", value, number)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", value)
End Try
' Displays:
'    Unable to parse '$16,321,421.75'.  

' Parse a number in exponential notation
value = "1.62345e-02"
Try
   number = Decimal.Parse(value)
   Console.WriteLine("'{0}' converted to {1}.", value, number)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", value)
End Try
' Displays: 
'    Unable to parse '1.62345e-02'.

注釈

パラメーター s には、次の形式の数が含まれている。

[ws][sign][digits,]digits[.fractional-digits][ws]

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

要素 説明
ws 省略可能な空白。
sign 省略可能な記号。
数値 0 ~ 9 の範囲の数字のシーケンス。
, カルチャ固有の桁区切り記号。
. カルチャ固有の小数点記号。
小数部の数字 0 ~ 9 の範囲の数字のシーケンス。

パラメーター s はスタイルを使用して解釈され NumberStyles.Number ます。 つまり、空白と桁区切り記号は許可されますが、通貨記号は使用できません。 で使用できる要素 (通貨記号、桁区切り記号、空白文字など) を明示的に定義するに s は、メソッドまたはメソッドを使用し Decimal.Parse(String, NumberStyles) Decimal.Parse(String, NumberStyles, IFormatProvider) ます。

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

必要に応じて、の値は s 近似値に丸められて丸められます。

Decimal 有効桁数は29桁です。 が s 29 桁を超える数値を表していて、小数部を持ち、かつの範囲内にある場合、数値は切り捨てられず、切り捨てられずに、 MaxValue MinValue 近似値に丸められて29桁に丸められます。

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

こちらもご覧ください

適用対象