Decimal.TryParse Метод

Исходный код:

Decimal.cs

Исходный код:

Decimal.cs

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

Параметры

Возвращаемое значение

true, если utf8Text был успешно преобразован; в противном случае false.

Исходный код:

Decimal.cs

Исходный код:

Decimal.cs

Исходный код:

Decimal.cs

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

Параметры

Возвращаемое значение

true, если s был успешно преобразован; в противном случае false.

Исходный код:

Decimal.cs

Исходный код:

Decimal.cs

Исходный код:

Decimal.cs

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

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

Параметры

Возвращаемое значение

true, если s был успешно преобразован; в противном случае false.

Примеры

В следующем примере используется метод Decimal.TryParse(String, Decimal) для преобразования строковых представлений числовых значений в Decimal значений. Предполагается, что en-US является текущим языком и региональными параметрами.

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

Комментарии

Эта перегрузка отличается от метода Decimal.Parse(String) путем возврата логического значения, указывающего, выполнена ли операция синтаксического анализа вместо возврата числового значения синтаксического анализа. Это устраняет необходимость использовать обработку исключений для проверки FormatException в случае, если s является недопустимым и не может быть успешно проанализирован.

Параметр s содержит ряд форм:

[ws] [знак] [цифры,]цифры[.дробные цифры][ws]

Элементы в квадратных скобках ([ и ]) являются необязательными. В следующей таблице описан каждый элемент.

Параметр s интерпретируется с помощью стиля NumberStyles.Number. Это означает, что разрешены пробелы и тысячи разделителей, но символы валюты не являются. Чтобы явно определить элементы (например, символы валюты, разделители тысяч и пробелы), которые могут присутствовать в s, используйте перегрузку метода Decimal.TryParse(String, NumberStyles, IFormatProvider, Decimal).

Параметр s анализируется с помощью сведений о форматировании в объекте NumberFormatInfo, инициализированном для текущего языка и региональных параметров системы. Дополнительные сведения см. в CurrentInfo. Чтобы проанализировать строку с помощью сведений о форматировании другого указанного языка и региональных параметров, используйте перегрузку метода Decimal.TryParse(String, NumberStyles, IFormatProvider, Decimal).

При необходимости значение s округляется с помощью округления до ближайшего.

Объект Decimal имеет 29 цифр точности. Если s представляет число, которое имеет более 29 цифр, но имеет дробную часть и находится в диапазоне от MaxValue и MinValue, число округляется, а не усечено до 29 цифр, используя округление до ближайшей.

Если во время операции синтаксического анализа в параметре s обнаруживается разделитель, а применимые денежные или числовые разделители и разделители групп совпадают, операция синтаксического анализа предполагает, что разделитель является десятичным разделителем, а не разделителем группы. Дополнительные сведения о разделителях см. в разделе CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparatorи NumberGroupSeparator.

См. также раздел

• Parse
• ToString()
• синтаксический анализ числовых строк в .NET

Исходный код:

Decimal.cs

Исходный код:

Decimal.cs

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

Параметры

Возвращаемое значение

true, если utf8Text был успешно проанализирован; в противном случае false.

Исходный код:

Decimal.cs

Исходный код:

Decimal.cs

Исходный код:

Decimal.cs

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

Параметры

Возвращаемое значение

true, если s был успешно проанализирован; в противном случае false.

Исходный код:

Decimal.cs

Исходный код:

Decimal.cs

Исходный код:

Decimal.cs

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

Параметры

Возвращаемое значение

true, если s был успешно проанализирован; в противном случае false.

Исходный код:

Decimal.cs

Исходный код:

Decimal.cs

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

Параметры

Возвращаемое значение

true, если utf8Text был успешно проанализирован; в противном случае false.

Исходный код:

Decimal.cs

Исходный код:

Decimal.cs

Исходный код:

Decimal.cs

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

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

Параметры

Возвращаемое значение

true, если s был успешно преобразован; в противном случае false.

Исходный код:

Decimal.cs

Исходный код:

Decimal.cs

Исходный код:

Decimal.cs

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

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

Параметры

Возвращаемое значение

true, если s был успешно преобразован; в противном случае false.

Исключения

Примеры

В следующем примере показано использование метода TryParse(String, NumberStyles, IFormatProvider, Decimal) для анализа строкового представления числа с определенным стилем и форматирования с использованием соглашений определенного языка и региональных параметров.

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'.

Комментарии

Эта перегрузка отличается от метода Decimal.Parse(String, NumberStyles, IFormatProvider) путем возврата логического значения, указывающего, выполнена ли операция синтаксического анализа вместо возврата числового значения синтаксического анализа. Это устраняет необходимость использовать обработку исключений для проверки FormatException в случае, если s является недопустимым и не может быть успешно проанализирован.

Параметр style определяет допустимый формат параметра s для успешной операции синтаксического анализа. Это должно быть сочетание битовых флагов из перечисления NumberStyles. Следующие NumberStyles члены не поддерживаются:

• NumberStyles.AllowHexSpecifier

• NumberStyles.HexNumber

В зависимости от значения стиля параметр s может включать следующие элементы:

[ws] [$] [знак] [цифры,]цифры[.дробные цифры][знак][знак][ws]

Элементы в квадратных скобках ([ и ]) являются необязательными. В следующей таблице описан каждый элемент.

Параметр style указывает разрешенный формат параметра s и может быть одним или несколькими NumberStyles перечисленными константами, объединенными с помощью побитовой операции OR. Если style имеет значение NULL, s интерпретируется с помощью стиля NumberStyles.Number.

Параметр provider — это реализация IFormatProvider, например объект NumberFormatInfo или CultureInfo. Параметр provider предоставляет сведения о языках и региональных параметрах, используемых в синтаксическом анализе. Если providernull, используется текущий язык и региональные параметры потока.

Объект Decimal имеет 29 цифр точности. Если s представляет число, которое имеет более 29 цифр, но имеет дробную часть и находится в диапазоне от MaxValue и MinValue, число округляется, а не усечено до 29 цифр, используя округление до ближайшей.

Если разделитель обнаружен в параметре s во время операции синтаксического анализа, а применимые денежные или числовые разделители и разделители групп совпадают, операция синтаксического анализа предполагает, что разделитель является десятичным разделителем, а не разделителем групп. Дополнительные сведения о разделителях см. в разделе CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparatorи NumberGroupSeparator.

См. также раздел

• Parse
• ToString()
• синтаксический анализ числовых строк в .NET