Decimal.TryParse Method

Definition

Namespace:

System

Assemblies:

netstandard.dll, System.Runtime.dll

Converts the string representation of a number to its Decimal equivalent. A return value indicates whether the conversion succeeded or failed.

Overloads

TryParse(ReadOnlySpan<Byte>, Decimal)	Tries to convert a UTF-8 character span containing the string representation of a number to its signed decimal equivalent.
TryParse(ReadOnlySpan<Char>, Decimal)	Converts the span representation of a number to its Decimal equivalent using the culture-specific format. A return value indicates whether the conversion succeeded or failed.
TryParse(String, Decimal)	Converts the string representation of a number to its Decimal equivalent. A return value indicates whether the conversion succeeded or failed.
TryParse(ReadOnlySpan<Byte>, IFormatProvider, Decimal)	Tries to parse a span of UTF-8 characters into a value.
TryParse(ReadOnlySpan<Char>, IFormatProvider, Decimal)	Tries to parse a span of characters into a value.
TryParse(String, IFormatProvider, Decimal)	Tries to parse a string into a value.
TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, Decimal)	Tries to parse a span of UTF-8 characters into a value.
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Decimal)	Converts the span representation of a number to its Decimal equivalent using the specified style and culture-specific format. A return value indicates whether the conversion succeeded or failed.
TryParse(String, NumberStyles, IFormatProvider, Decimal)	Converts the string representation of a number to its Decimal equivalent using the specified style and culture-specific format. A return value indicates whether the conversion succeeded or failed.

TryParse(ReadOnlySpan<Byte>, Decimal)

Source:

Decimal.cs

Tries to convert a UTF-8 character span containing the string representation of a number to its signed decimal equivalent.

C#

public static bool TryParse(ReadOnlySpan<byte> utf8Text, out decimal result);

Parameters

utf8Text

ReadOnlySpan<Byte>

A span containing the UTF-8 characters representing the number to convert.

result

Decimal

When this method returns, contains the signed decimal value equivalent to the number contained in utf8Text if the conversion succeeded, or zero if the conversion failed. This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

Returns

Boolean

true if utf8Text was converted successfully; otherwise, false.

TryParse(ReadOnlySpan<Char>, Decimal)

Source:

Decimal.cs

Converts the span representation of a number to its Decimal equivalent using the culture-specific format. A return value indicates whether the conversion succeeded or failed.

C#

public static bool TryParse(ReadOnlySpan<char> s, out decimal result);

Parameters

s

ReadOnlySpan<Char>

A span containing the characters representing the number to convert.

result

Decimal

When this method returns, contains the Decimal number that is equivalent to the numeric value contained in s, if the conversion succeeded, or zero if the conversion failed. The conversion fails if the s parameter is null or Empty or represents a number less than Decimal.MinValue or greater than Decimal.MaxValue. This parameter is passed uininitialized; any value originally supplied in result is overwritten.

Returns

Boolean

true if s was converted successfully; otherwise, false.

TryParse(String, Decimal)

Source:

Decimal.cs

Converts the string representation of a number to its Decimal equivalent. A return value indicates whether the conversion succeeded or failed.

C#

public static bool TryParse(string? s, out decimal result);

Parameters

s

String

The string representation of the number to convert.

result

Decimal

When this method returns, contains the Decimal number that is equivalent to the numeric value contained in s, if the conversion succeeded, or zero if the conversion failed. The conversion fails if the s parameter is null or Empty, is not a number in a valid format, or represents a number less than Decimal.MinValue or greater than Decimal.MaxValue. This parameter is passed uininitialized; any value originally supplied in result is overwritten.

Returns

Boolean

true if s was converted successfully; otherwise, false.

Examples

The following example uses the Decimal.TryParse(String, Decimal) method to convert the string representations of numeric values to Decimal values. It assumes that en-US is the current culture.

C#

string value;
decimal number;

// Parse a floating-point value with a thousands separator.
value = "1,643.57";
if (Decimal.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 (Decimal.TryParse(value, out number))
   Console.WriteLine(number);
else
   Console.WriteLine("Unable to parse '{0}'.", value);

// Parse value in exponential notation.
value = "-1.643e6";
if (Decimal.TryParse(value, out number))
   Console.WriteLine(number);
else
   Console.WriteLine("Unable to parse '{0}'.", value);

// Parse a negative integer value.
value = "-1689346178821";
if (Decimal.TryParse(value, out number))
   Console.WriteLine(number);
else
   Console.WriteLine("Unable to parse '{0}'.", value);
// The example displays the following output to the console:
//       1643.57
//       Unable to parse '$1,643.57'.
//       Unable to parse '-1.643e6'.
//       -1689346178821

Remarks

This overload differs from the Decimal.Parse(String) method by returning a Boolean value that indicates whether the parse operation succeeded instead of returning the parsed numeric value. It eliminates the need to use exception handling to test for a FormatException in the event that s is invalid and cannot be successfully parsed.

Parameter s contains a number of the form:

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

Elements in square brackets ([ and ]) are optional. The following table describes each element.

Element	Description
ws	Optional white space.
sign	An optional sign.
digits	A sequence of digits ranging from 0 to 9.
,	A culture-specific thousands separator symbol.
.	A culture-specific decimal point symbol.
fractional-digits	A sequence of digits ranging from 0 to 9.

Parameter s is interpreted using the NumberStyles.Number style. This means that white space and thousands separators are allowed but currency symbols are not. To explicitly define the elements (such as currency symbols, thousands separators, and white space) that can be present in s, use the Decimal.TryParse(String, NumberStyles, IFormatProvider, Decimal) method overload.

Parameter s is parsed using the formatting information in a NumberFormatInfo object initialized for the current system culture. For more information, see CurrentInfo. To parse a string using the formatting information of some other specified culture, use the Decimal.TryParse(String, NumberStyles, IFormatProvider, Decimal) method overload.

If necessary, the value of s is rounded using rounding to nearest.

A Decimal object has 29 digits of precision. If s represents a number that has more than 29 digits, but has a fractional part and is within the range of MaxValue and MinValue, the number is rounded, not truncated, to 29 digits using rounding to nearest.

If during a parse operation a separator is encountered in the s parameter, and the applicable currency or number decimal and group separators are the same, the parse operation assumes that the separator is a decimal separator rather than a group separator. For more information about separators, see CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparator, and NumberGroupSeparator.

See also

• Parse
• ToString()
• Parsing Numeric Strings in .NET

TryParse(ReadOnlySpan<Byte>, IFormatProvider, Decimal)

Source:

Decimal.cs

Tries to parse a span of UTF-8 characters into a value.

C#

public static bool TryParse(ReadOnlySpan<byte> utf8Text, IFormatProvider? provider, out decimal result);

Parameters

utf8Text

ReadOnlySpan<Byte>

The span of UTF-8 characters to parse.

provider

IFormatProvider

An object that provides culture-specific formatting information about utf8Text.

result

Decimal

On return, contains the result of successfully parsing utf8Text or an undefined value on failure.

Returns

Boolean

true if utf8Text was successfully parsed; otherwise, false.

TryParse(ReadOnlySpan<Char>, IFormatProvider, Decimal)

Source:

Decimal.cs

Tries to parse a span of characters into a value.

C#

public static bool TryParse(ReadOnlySpan<char> s, IFormatProvider? provider, out decimal result);

Parameters

s

ReadOnlySpan<Char>

The span of characters to parse.

provider

IFormatProvider

An object that provides culture-specific formatting information about s.

result

Decimal

When this method returns, contains the result of successfully parsing s, or an undefined value on failure.

Returns

Boolean

true if s was successfully parsed; otherwise, false.

TryParse(String, IFormatProvider, Decimal)

Source:

Decimal.cs

Tries to parse a string into a value.

C#

public static bool TryParse(string? s, IFormatProvider? provider, out decimal result);

Parameters

s

String

The string to parse.

provider

IFormatProvider

An object that provides culture-specific formatting information about s.

result

Decimal

When this method returns, contains the result of successfully parsing s or an undefined value on failure.

Returns

Boolean

true if s was successfully parsed; otherwise, false.

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

Source:

Decimal.cs

Tries to parse a span of UTF-8 characters into a value.

C#

public static bool TryParse(ReadOnlySpan<byte> utf8Text, System.Globalization.NumberStyles style, IFormatProvider? provider, out decimal result);

Parameters

utf8Text

ReadOnlySpan<Byte>

The span of UTF-8 characters to parse.

style

NumberStyles

A bitwise combination of number styles that can be present in utf8Text.

provider

IFormatProvider

An object that provides culture-specific formatting information about utf8Text.

result

Decimal

On return, contains the result of successfully parsing utf8Text or an undefined value on failure.

Returns

Boolean

true if utf8Text was successfully parsed; otherwise, false.

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

Source:

Decimal.cs

Converts the span representation of a number to its Decimal equivalent using the specified style and culture-specific format. A return value indicates whether the conversion succeeded or failed.

C#

public static bool TryParse(ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider? provider, out decimal result);

Parameters

s

ReadOnlySpan<Char>

A span containing the characters representing the number to convert.

style

NumberStyles

A bitwise combination of enumeration values that indicates the permitted format of s. A typical value to specify is Number.

provider

IFormatProvider

An object that supplies culture-specific parsing information about s.

result

Decimal

When this method returns, contains the Decimal number that is equivalent to the numeric value contained in s, if the conversion succeeded, or zero if the conversion failed. The conversion fails if the s parameter is null or Empty, is not a number in a format compliant with style, or represents a number less than Decimal.MinValue or greater than Decimal.MaxValue. This parameter is passed uininitialized; any value originally supplied in result is overwritten.

Returns

Boolean

true if s was converted successfully; otherwise, false.

TryParse(String, NumberStyles, IFormatProvider, Decimal)

Source:

Decimal.cs

Converts the string representation of a number to its Decimal equivalent using the specified style and culture-specific format. A return value indicates whether the conversion succeeded or failed.

C#

public static bool TryParse(string? s, System.Globalization.NumberStyles style, IFormatProvider? provider, out decimal result);

Parameters

s

String

The string representation of the number to convert.

style

NumberStyles

A bitwise combination of enumeration values that indicates the permitted format of s. A typical value to specify is Number.

provider

IFormatProvider

An object that supplies culture-specific parsing information about s.

result

Decimal

When this method returns, contains the Decimal number that is equivalent to the numeric value contained in s, if the conversion succeeded, or zero if the conversion failed. The conversion fails if the s parameter is null or Empty, is not a number in a format compliant with style, or represents a number less than Decimal.MinValue or greater than Decimal.MaxValue. This parameter is passed uininitialized; any value originally supplied in result is overwritten.

Returns

Boolean

true if s was converted successfully; otherwise, false.

Exceptions

ArgumentException

style is not a NumberStyles value.

-or-

style is the AllowHexSpecifier value.

Examples

The following example demonstrates the use of the TryParse(String, NumberStyles, IFormatProvider, Decimal) method to parse the string representation of a number that has a particular style and is formatted using the conventions of a particular culture.

C#

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

// Parse currency value using en-GB culture.
value = "£1,097.63";
style = NumberStyles.Number | NumberStyles.AllowCurrencySymbol;
culture = CultureInfo.CreateSpecificCulture("en-GB");
if (Decimal.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 (Decimal.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 (Decimal.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 (Decimal.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'.

Remarks

This overload differs from the Decimal.Parse(String, NumberStyles, IFormatProvider) method by returning a Boolean value that indicates whether the parse operation succeeded instead of returning the parsed numeric value. It eliminates the need to use exception handling to test for a FormatException in the event that s is invalid and cannot be successfully parsed.

The style parameter defines the allowable format of the s parameter for the parse operation to succeed. It must be a combination of bit flags from the NumberStyles enumeration. The following NumberStyles members are not supported:

• NumberStyles.AllowHexSpecifier

• NumberStyles.HexNumber

Depending on the value of style, the s parameter may include the following elements:

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

Elements in square brackets ([ and ]) are optional. The following table describes each element.

Element	Description
ws	Optional white space. White space can appear at the beginning of s if style includes the NumberStyles.AllowLeadingWhite flag. It can appear at the end of s if style includes the NumberStyles.AllowTrailingWhite flag.
$	A culture-specific currency symbol. Its position in the string is defined by the NumberFormatInfo.CurrencyNegativePattern or NumberFormatInfo.CurrencyPositivePattern properties of the NumberFormatInfo object returned by the IFormatProvider.GetFormat method of the provider parameter. The currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.
sign	An optional sign.
digits	A sequence of digits ranging from 0 to 9.
.	A culture-specific decimal point symbol.
fractional-digits	A sequence of digits ranging from 0 to 9.

The style parameter specifies the permitted format of the s parameter, and can be one or more NumberStyles enumerated constants combined using a bitwise OR operation. If style is null, s is interpreted using the NumberStyles.Number style.

The provider parameter is an IFormatProvider implementation such as a NumberFormatInfo or CultureInfo object. The provider parameter supplies culture-specific information used in parsing. If provider is null, the thread current culture is used.

A Decimal object has 29 digits of precision. If s represents a number that has more than 29 digits, but has a fractional part and is within the range of MaxValue and MinValue, the number is rounded, not truncated, to 29 digits using rounding to nearest.

If a separator is encountered in the s parameter during a parse operation, and the applicable currency or number decimal and group separators are the same, the parse operation assumes that the separator is a decimal separator rather than a group separator. For more information about separators, see CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparator, and NumberGroupSeparator.

See also

• Parse
• ToString()
• Parsing Numeric Strings in .NET