Double.TryParse Метод

Определение

Преобразует строковое представление числа в эквивалентное ему число двойной точности с плавающей запятой.Converts the string representation of a number to its double-precision floating-point number equivalent. Возвращает значение, указывающее, успешно ли выполнено преобразование.A return value indicates whether the conversion succeeded or failed.

Перегрузки

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

Преобразует диапазон символов, содержащий строковое представление числа в указанном стиле и с использованием формата, соответствующего данному языку и региональным параметрам, в эквивалентное ему число с плавающей запятой двойной точности.Converts a character span containing the string representation of a number in a specified style and culture-specific format to its double-precision floating-point number equivalent. Возвращает значение, указывающее, успешно ли выполнено преобразование.A return value indicates whether the conversion succeeded or failed.

TryParse(String, Double)

Преобразует строковое представление числа в эквивалентное ему число двойной точности с плавающей запятой.Converts the string representation of a number to its double-precision floating-point number equivalent. Возвращает значение, указывающее, успешно ли выполнено преобразование.A return value indicates whether the conversion succeeded or failed.

TryParse(ReadOnlySpan<Char>, Double)

Преобразует представление диапазона числа указанного стиля, выраженное в формате, соответствующем определенному языку и региональным параметрам, в эквивалентное ему число двойной точности с плавающей запятой.Converts the span representation of a number in a specified style and culture-specific format to its double-precision floating-point number equivalent. Возвращает значение, указывающее, успешно ли выполнено преобразование.A return value indicates whether the conversion succeeded or failed.

TryParse(String, NumberStyles, IFormatProvider, Double)

Преобразует строковое представление числа указанного стиля, выраженное в формате, соответствующем определенному языку и региональным параметрам, в эквивалентное ему число двойной точности с плавающей запятой.Converts the string representation of a number in a specified style and culture-specific format to its double-precision floating-point number equivalent. Возвращает значение, указывающее, успешно ли выполнено преобразование.A return value indicates whether the conversion succeeded or failed.

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

Преобразует диапазон символов, содержащий строковое представление числа в указанном стиле и с использованием формата, соответствующего данному языку и региональным параметрам, в эквивалентное ему число с плавающей запятой двойной точности.Converts a character span containing the string representation of a number in a specified style and culture-specific format to its double-precision floating-point number equivalent. Возвращает значение, указывающее, успешно ли выполнено преобразование.A return value indicates whether the conversion succeeded or failed.

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, 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>

Диапазон символов только для чтения, содержащий преобразуемое число.A read-only character span that contains the number to convert.

style
NumberStyles

Побитовое сочетание значений NumberStyles, определяющее разрешенный формат параметра s.A bitwise combination of NumberStyles values that indicates the permitted format of s. Обычно указывается значение Float в сочетании со значением AllowThousands.A typical value to specify is Float combined with AllowThousands.

provider
IFormatProvider

Объект, который предоставляет сведения о форматировании параметра s в зависимости от языка и региональных параметров.An object that supplies culture-specific formatting information about s.

result
Double

При возврате этого метода и успешном завершении преобразования содержит число двойной точности с плавающей запятой, эквивалентное числовому значению или символу, содержащемуся в параметре s.When this method returns and if the conversion succeeded, contains a double-precision floating-point number equivalent of the numeric value or symbol contained in s. Если преобразование завершилось неудачей, содержит ноль.Contains zero if the conversion failed. Преобразование не удается выполнить, если параметр s является null, пустым диапазоном символов или числом в формате, несовместимом с style.The conversion fails if the s parameter is null, an empty character span, or not a number in a format compliant with style. Если s является допустимым числом меньше MinValue, result имеет значение NegativeInfinity.If s is a valid number less than MinValue, result is NegativeInfinity. Если s является допустимым числом больше MaxValue, result имеет значение PositiveInfinity.If s is a valid number greater than MaxValue, result is PositiveInfinity. Этот параметр передается неинициализированным; любое значение, первоначально предоставленное в result, будет перезаписано.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

Возвраты

Значение true, если параметр s успешно преобразован; в противном случае — значение false.true if s was converted successfully; otherwise, false.

TryParse(String, Double)

Преобразует строковое представление числа в эквивалентное ему число двойной точности с плавающей запятой.Converts the string representation of a number to its double-precision floating-point number equivalent. Возвращает значение, указывающее, успешно ли выполнено преобразование.A return value indicates whether the conversion succeeded or failed.

public:
 static bool TryParse(System::String ^ s, [Runtime::InteropServices::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

Строка, содержащая преобразуемое число.A string containing a number to convert.

result
Double

При возврате этот метод содержит число двойной точности с плавающей запятой, эквивалентное параметру s, если преобразование завершилось успешно, или нуль, если оно завершилось неудачно.When this method returns, contains the double-precision floating-point number equivalent of the s parameter, if the conversion succeeded, or zero if the conversion failed. Преобразование не удается выполнить, если параметр s имеет значение null или Empty или не является числом в допустимом формате.The conversion fails if the s parameter is null or Empty or is not a number in a valid format. Сбой происходит в .NET Framework и .NET Core 2.2 и более ранних версиях, если s представляет число меньше MinValue или больше MaxValue.It also fails on .NET Framework and .NET Core 2.2 and earlier versions if s represents a number less than MinValue or greater than MaxValue. Этот параметр передается неинициализированным; любое значение, первоначально предоставленное в result, будет перезаписано.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

Возвраты

Значение true, если параметр s успешно преобразован; в противном случае — значение false.true if s was converted successfully; otherwise, false.

Примеры

В следующем примере используется метод TryParse(String, Double) для преобразования строковых представлений числовых значений в Double значения.The following example uses the TryParse(String, Double) method to convert the string representations of numeric values to Double values. Предполагается, что en-US является текущим языком и региональными параметрами.It assumes that en-US is the current culture.

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

Комментарии

Эта перегрузка отличается от метода Double.Parse(String), возвращая логическое значение, которое указывает, была ли операция анализа успешной, а не возвращать проанализированное числовое значение.This overload differs from the Double.Parse(String) method by returning a Boolean value that indicates whether the parse operation succeeded instead of returning the parsed numeric value. Это устраняет необходимость использования обработки исключений для проверки FormatException в случае, если s недопустим и не может быть успешно проанализирован.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.

Параметр s может содержать NumberFormatInfo.PositiveInfinitySymbolтекущего языка и региональных параметров, NumberFormatInfo.NegativeInfinitySymbol, NumberFormatInfo.NaNSymbol (сравнение строк учитывает регистр) или строку в форме:The s parameter can contain the current culture's NumberFormatInfo.PositiveInfinitySymbol, NumberFormatInfo.NegativeInfinitySymbol, NumberFormatInfo.NaNSymbol (the string comparison is case-sensitive), or a string of the form:

Протокол писать [целые числа,] целые цифры [. [ дробные цифры]] [e [знак] экспоненциальные цифры] [ws][ws][sign][integral-digits,]integral-digits[.[fractional-digits]][e[sign]exponential-digits][ws]

Элементы в квадратных скобках являются необязательными.Elements in square brackets are optional. Каждый из элементов описан в таблице ниже.The following table describes each element.

ЭлементElement ОписаниеDescription
wsws Последовательность пробельных символов.A series of white-space characters.
signsign Знак отрицательного или положительного знака.A negative sign or positive sign symbol.
целые числаintegral-digits Последовательность числовых символов в диапазоне от 0 до 9, которые указывают целую часть числа.A series of numeric characters ranging from 0 to 9 that specify the integral part of the number. Целочисленные цифры могут отсутствовать, если есть дробные разряды.Integral-digits can be absent if there are fractional-digits.
,, Символ разделителя группы, зависящий от языка и региональных параметров.A culture-specific group separator symbol.
.. Символ десятичной запятой, зависящий от языка и региональных параметров.A culture-specific decimal point symbol.
Дробные разрядыfractional-digits Последовательность числовых символов в диапазоне от 0 до 9, которые указывают дробную часть числа.A series of numeric characters ranging from 0 to 9 that specify the fractional part of the number.
EE Прописная или строчная буква "e", которая указывает на экспоненциальную (экспоненциальную) нотацию.An uppercase or lowercase character 'e', that indicates exponential (scientific) notation.
экспоненциальные цифрыexponential-digits Последовательность числовых символов в диапазоне от 0 до 9, задающих показатель степени.A series of numeric characters ranging from 0 to 9 that specify an exponent.

Дополнительные сведения о числовых форматах см. в разделе Типы форматирования.For more information about numeric formats, see Formatting Types.

Параметр s интерпретируется с помощью сочетания флагов NumberStyles.Float и NumberStyles.AllowThousands.The s parameter is interpreted by using a combination of the NumberStyles.Float and NumberStyles.AllowThousands flags. Это означает, что пробелы и разделители групп разрядов разрешены, а символы валют — нет.This means that white space and thousands separators are allowed but currency symbols are not. Чтобы явно определить элементы (например, символы валют, разделители тысяч и пробелы), которые могут присутствовать в s, используйте перегрузку метода Double.TryParse(String, NumberStyles, IFormatProvider, Double).To explicitly define the elements (such as currency symbols, thousands separators, and white space) that can be present in s, use the Double.TryParse(String, NumberStyles, IFormatProvider, Double) method overload.

Параметр s анализируется с помощью сведений о форматировании в объекте NumberFormatInfo, который инициализируется для текущего языка и региональных параметров системы.The s parameter is parsed using the formatting information in a NumberFormatInfo object that is initialized for the current system culture. Для получения дополнительной информации см. NumberFormatInfo.CurrentInfo.For more information, see NumberFormatInfo.CurrentInfo. Чтобы выполнить синтаксический анализ строки, используя сведения о форматировании некоторых других указанных региональных параметров, используйте перегрузку метода Double.TryParse(String, NumberStyles, IFormatProvider, Double).To parse a string using the formatting information of some other specified culture, use the Double.TryParse(String, NumberStyles, IFormatProvider, Double) method overload.

Обычно при передаче метода Double.TryParse строку, созданную путем вызова метода Double.ToString, возвращается исходное значение Double.Ordinarily, if you pass the Double.TryParse method a string that is created by calling the Double.ToString method, the original Double value is returned. Однако из-за потери точности значения могут не совпадать.However, because of a loss of precision, the values may not be equal. Кроме того, попытка выполнить синтаксический анализ строкового представления либо Double.MinValue, либо Double.MaxValue не дает круговой обработки.In addition, attempting to parse the string representation of either Double.MinValue or Double.MaxValue fails to round-trip. В .NET Framework и .NET Core 2,2 и предыдущих версиях она выдает исключение OverflowException.On .NET Framework and .NET Core 2.2 and previous versions, it throws an OverflowException. В .NET Core 3,0 и более поздних версиях он возвращает Double.NegativeInfinity при попытке выполнить синтаксический анализ MinValue или Double.PositiveInfinity при попытке проанализировать MaxValue.On .NET Core 3.0 and later versions, it returns Double.NegativeInfinity if you attempt to parse MinValue or Double.PositiveInfinity if you attempt to parse MaxValue. Ниже приведен пример.The following example provides an illustration.

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.            
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 и более ранних версиях, если s выходит за пределы диапазона Double типа данных, метод TryParse(String, Double) создает исключение OverflowException.On .NET Framework and .NET Core 2.2 and earlier versions, if s is out of range of the Double data type, the TryParse(String, Double) method throws an OverflowException.

В .NET Core 3,0 и более поздних версиях исключение не возникает, если s выходит за пределы диапазона Doubleного типа данных.On .NET Core 3.0 and later versions, no exception is thrown when s is out of range of the Double data type. В большинстве случаев TryParse(String, Double) метод вычисляет результат Double.PositiveInfinity или Double.NegativeInfinity.In most cases, the TryParse(String, Double) method calculates a result of Double.PositiveInfinity or Double.NegativeInfinity. Однако существует небольшой набор значений, которые считаются ближе к максимальному или минимальному значению Double, чем положительная или отрицательная бесконечность.However, there is a small set of values that are considered to be closer to the maximum or minimum values of Double than to positive or negative infinity. В таких случаях метод вычисляет результат Double.MaxValue или Double.MinValue.In those cases, the method calculates a result of Double.MaxValue or Double.MinValue.

Если в параметре s во время операции синтаксического анализа обнаружен разделитель, а разделители десятичных и групп одинаковы, то операция синтаксического анализа предполагает, что разделитель является десятичным разделителем, а не разделителем групп.If a separator is encountered in the s parameter during a parse operation, and the decimal and group separators are the same, the parse operation assumes that the separator is a decimal separator rather than a group separator. Дополнительные сведения о разделителях см. в разделе CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparatorи NumberGroupSeparator.For more information about separators, see CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparator, and NumberGroupSeparator.

Дополнительно

TryParse(ReadOnlySpan<Char>, Double)

Преобразует представление диапазона числа указанного стиля, выраженное в формате, соответствующем определенному языку и региональным параметрам, в эквивалентное ему число двойной точности с плавающей запятой.Converts the span representation of a number in a specified style and culture-specific format to its double-precision floating-point number equivalent. Возвращает значение, указывающее, успешно ли выполнено преобразование.A return value indicates whether the conversion succeeded or failed.

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>

Диапазон символов, содержащий строковое представление числа, которое нужно преобразовать.A character span that contains the string representation of the number to convert.

result
Double

При возврате этот метод содержит число двойной точности с плавающей запятой, эквивалентное числовому значению или символу, содержащемуся в параметре s, если преобразование завершилось успешно, или ноль, если оно завершилось неудачно.When this method returns, contains the double-precision floating-point number equivalent of the numeric value or symbol contained in s parameter, if the conversion succeeded, or zero if the conversion failed. Преобразование не удается выполнить, если параметр s имеет значение null, является пустым или имеет формат, несовместимый со значением style.The conversion fails if the s parameter is null or empty, or is not in a format compliant with style. Преобразование также завершается ошибкой, если style не является допустимым сочетанием перечисленных констант NumberStyles.The conversion also fails if style is not a valid combination of NumberStyles enumerated constants. Если s является допустимым числом меньше MinValue, result имеет значение NegativeInfinity.If s is a valid number less than MinValue, result is NegativeInfinity. Если s является допустимым числом больше MaxValue, result имеет значение PositiveInfinity.If s is a valid number greater than MaxValue, result is PositiveInfinity. Этот параметр передается неинициализированным; любое значение, первоначально предоставленное в result, будет перезаписано.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

Возвраты

Значение true, если параметр s успешно преобразован; в противном случае — значение false.true if s was converted successfully; otherwise, false.

TryParse(String, NumberStyles, IFormatProvider, Double)

Преобразует строковое представление числа указанного стиля, выраженное в формате, соответствующем определенному языку и региональным параметрам, в эквивалентное ему число двойной точности с плавающей запятой.Converts the string representation of a number in a specified style and culture-specific format to its double-precision floating-point number equivalent. Возвращает значение, указывающее, успешно ли выполнено преобразование.A return value indicates whether the conversion succeeded or failed.

public:
 static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::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

Строка, содержащая преобразуемое число.A string containing a number to convert.

style
NumberStyles

Побитовое сочетание значений NumberStyles, определяющее разрешенный формат параметра s.A bitwise combination of NumberStyles values that indicates the permitted format of s. Обычно указывается значение Float в сочетании со значением AllowThousands.A typical value to specify is Float combined with AllowThousands.

provider
IFormatProvider

Интерфейс IFormatProvider предоставляет сведения о форматировании параметра s для соответствующего языка и региональных параметров.An IFormatProvider that supplies culture-specific formatting information about s.

result
Double

При возврате этот метод содержит число двойной точности с плавающей запятой, эквивалентное числовому значению или символу, содержащемуся в параметре s, если преобразование завершилось успешно, или нуль, если оно завершилось неудачно.When this method returns, contains a double-precision floating-point number equivalent of the numeric value or symbol contained in s, if the conversion succeeded, or zero if the conversion failed. Преобразование завершается неудачно, если параметр s имеет значение null или Empty, не является значением в формате, совместимом с параметром style или если style не является допустимой комбинацией перечисленных констант NumberStyles.The conversion fails if the s parameter is null or Empty or is not in a format compliant with style, or if style is not a valid combination of NumberStyles enumeration constants. Сбой происходит в .NET Framework или .NET Core 2.2 и более ранних версиях, если s представляет число меньше MinValue или больше MaxValue.It also fails on .NET Framework or .NET Core 2.2 and earlier versions if s represents a number less than MinValue or greater than MaxValue. Этот параметр передается неинициализированным; любое значение, первоначально предоставленное в result, будет перезаписано.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

Возвраты

Значение true, если параметр s успешно преобразован; в противном случае — значение false.true if s was converted successfully; otherwise, false.

Исключения

style не является значением NumberStyles.style is not a NumberStyles value.

- или --or- style включает значение AllowHexSpecifier.style includes the AllowHexSpecifier value.

Примеры

В следующем примере показано использование метода Double.TryParse(String, NumberStyles, IFormatProvider, Double) для анализа строкового представления чисел, имеющих определенный стиль и отформатированных с использованием соглашений определенного языка и региональных параметров.The following example demonstrates the use of the Double.TryParse(String, NumberStyles, IFormatProvider, Double) method to parse the string representation of numbers that have a particular style and are formatted using the conventions of a particular culture.

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

Комментарии

Метод TryParse похож на метод Parse(String, NumberStyles, IFormatProvider), за исключением того, что этот метод не создает исключение в случае сбоя преобразования.The TryParse method is like the Parse(String, NumberStyles, IFormatProvider) method, except this method does not throw an exception if the conversion fails. Если преобразование выполнено, возвращается значение true и параметру result присваивается результат преобразования.If the conversion succeeds, the return value is true and the result parameter is set to the outcome of the conversion. Если преобразование завершается неудачно, возвращается значение false и параметр result имеет значение 0.If the conversion fails, the return value is false and the result parameter is set to zero. Это избавляет от необходимости использовать обработку исключений для проверки FormatException в случае, если s недопустим и не может быть успешно проанализирован.This eliminates the need to use exception handling to test for a FormatException in the event that s is invalid and cannot be successfully parsed.

Параметр style определяет допустимый формат параметра s для выполнения операции синтаксического анализа.The style parameter defines the allowable format of the s parameter for the parse operation to succeed. Он должен представлять собой сочетание битовых флагов из перечисления NumberStyles.It must be a combination of bit flags from the NumberStyles enumeration. Следующие элементы NumberStyles не поддерживаются:The following NumberStyles members are not supported:

Параметр s может содержать NumberFormatInfo.PositiveInfinitySymbol, NumberFormatInfo.NegativeInfinitySymbolили NumberFormatInfo.NaNSymbol для языка и региональных параметров, указанных provider.The s parameter can contain NumberFormatInfo.PositiveInfinitySymbol, NumberFormatInfo.NegativeInfinitySymbol, or NumberFormatInfo.NaNSymbol for the culture indicated by provider. Кроме того, в зависимости от значения styleпараметр s может включать следующие элементы:In addition, depending on the value of style, the s parameter may include the following elements:

Протокол [$] писать [целые числа,] целочисленные цифры [. дробные цифры] [e [знак] экспоненциальные цифры] [ws][ws] [$] [sign][integral-digits,]integral-digits[.fractional-digits][e[sign]exponential-digits][ws]

Элементы в квадратных скобках ([и]) являются необязательными.Elements in square brackets ([ and ]) are optional. Каждый из элементов описан в таблице ниже.The following table describes each element.

ЭлементElement ОписаниеDescription
wsws Необязательный пробел.Optional white space. Пробелы могут находиться в начале s если style включает флаг NumberStyles.AllowLeadingWhite.White space can appear at the beginning of s if style includes the NumberStyles.AllowLeadingWhite flag. Он может находиться в конце s если style включает флаг NumberStyles.AllowTrailingWhite.It can appear at the end of s if style includes the NumberStyles.AllowTrailingWhite flag.
$ Символ валюты, зависящий от языка и региональных параметров.A culture-specific currency symbol. Его расположение в строке определяется свойствами NumberFormatInfo.CurrencyNegativePattern или NumberFormatInfo.CurrencyPositivePattern объекта NumberFormatInfo, возвращаемого методом IFormatProvider.GetFormat параметра provider.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. Символ валюты может отображаться в s, если style включает флаг NumberStyles.AllowCurrencySymbol.The currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign Необязательный знак.An optional sign. Знак может располагаться в начале s если style включает флаг NumberStyles.AllowLeadingSign и может находиться в конце s, если style включает флаг NumberStyles.AllowTrailingSign.The sign can appear at the beginning of s if style includes the NumberStyles.AllowLeadingSign flag, and it can appear at the end of s if style includes the NumberStyles.AllowTrailingSign flag. Круглые скобки можно использовать в s, чтобы указать отрицательное значение, если style включает флаг NumberStyles.AllowParentheses.Parentheses can be used in s to indicate a negative value if style includes the NumberStyles.AllowParentheses flag.
целые числаintegral-digits Последовательность цифр от 0 до 9, указывающих целую часть числа.A series of digits ranging from 0 to 9 that specify the integral part of the number. Целочисленные цифры могут отсутствовать, если есть дробные разряды.Integral-digits can be absent if there are fractional-digits.
,, Символ разделителя тысяч, зависящий от языка и региональных параметров.A culture-specific thousands separator symbol. Символ разделителя тысяч текущего языка и региональных параметров может отображаться в s, если style включает флаг NumberStyles.AllowThousands.The current culture's thousands separator symbol can appear in s if style includes the NumberStyles.AllowThousands flag.
.. Символ десятичной запятой, зависящий от языка и региональных параметров.A culture-specific decimal point symbol. Символ десятичной запятой текущего языка и региональных параметров может присутствовать в s, если style включает флаг NumberStyles.AllowDecimalPoint.The current culture's decimal point symbol can appear in s if style includes the NumberStyles.AllowDecimalPoint flag.
Дробные разрядыfractional-digits Последовательность цифр от 0 до 9, которая указывает дробную часть числа.A series of digits ranging from 0 to 9 that specify the fractional part of the number. Дробные цифры могут присутствовать в s, если style включает флаг NumberStyles.AllowDecimalPoint.Fractional digits can appear in s if style includes the NumberStyles.AllowDecimalPoint flag.
ee Символ e или E, указывающий, что s может представлять число с помощью экспоненциальной нотации.The e or E character, which indicates that s can represent a number using exponential notation. Параметр s может представлять число в экспоненциальной нотации, если style включает флаг NumberStyles.AllowExponent.The s parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
экспоненциальные цифрыexponential-digits Последовательность цифр от 0 до 9, указывающая показатель степени.A series of digits ranging from 0 to 9 that specify an exponent.

Примечание

Все завершающие символы NUL (U + 0000) в s игнорируются операцией синтаксического анализа независимо от значения аргумента style.Any terminating NUL (U+0000) characters in s are ignored by the parsing operation, regardless of the value of the style argument.

Строка с цифрами (которая соответствует стилю NumberStyles.None) всегда будет успешно проанализирована, если она находится в диапазоне типа Double.A string with digits only (which corresponds to the NumberStyles.None style) always parses successfully if it is in the range of the Double type. Остальные System.Globalization.NumberStyles элементы управления, которые могут быть, но не обязательно присутствовать во входной строке.The remaining System.Globalization.NumberStyles members control elements that may be but are not required to be present in the input string. В следующей таблице показано, как отдельные флаги NumberStyles влияют на элементы, которые могут присутствовать в s.The following table indicates how individual NumberStyles flags affect the elements that may be present in s.

Значение NumberStylesNumberStyles value Элементы, разрешенные в s в дополнение к цифрамElements permitted in s in addition to digits
None Только элемент с целыми цифрами .The integral-digits element only.
AllowDecimalPoint Языковой элемент .The . и дробные разрядные элементы.and fractional-digits elements.
AllowExponent Параметр s может также использовать экспоненциальную нотацию.The s parameter can also use exponential notation. Этот флаг сам по себе поддерживает значения в видеэкспоненциальныхразрядов E- цифр. Дополнительные флаги необходимы для успешного анализа строк в экспоненциальной нотации с такими элементами, как положительные или отрицательные знаки и символы десятичной запятой.This flag by itself supports values in the form integral-digitsEexponential-digits; additional flags are needed to successfully parse strings in exponential notation with such elements as positive or negative signs and decimal point symbols.
AllowLeadingWhite Элемент WS в начале s.The ws element at the beginning of s.
AllowTrailingWhite Элемент WS в конце s.The ws element at the end of s.
AllowLeadingSign Элемент Sign в начале s.The sign element at the beginning of s.
AllowTrailingSign Элемент Sign в конце s.The sign element at the end of s.
AllowParentheses Элемент Sign в виде круглых скобок, охватывающих числовое значение.The sign element in the form of parentheses enclosing the numeric value.
AllowThousands Элемент , .The , element.
AllowCurrencySymbol Элемент $ .The $ element.
Currency Все.All. Параметр s не может представлять шестнадцатеричное число или число в экспоненциальной нотации.The s parameter cannot represent a hexadecimal number or a number in exponential notation.
Float Элемент WS в начале или в конце s, знак в начале sи .The ws element at the beginning or end of s, sign at the beginning of s, and the . знак.symbol. Параметр s может также использовать экспоненциальную нотацию.The s parameter can also use exponential notation.
Number Элементы ws, sign, разделителей тысяч (,) и десятичной запятой (.).The ws, sign, thousands separator (,), and decimal point (.) elements.
Any Все стили, кроме s, не могут представлять шестнадцатеричное число.All styles, except s cannot represent a hexadecimal number.

Параметр provider — это реализация IFormatProvider, например объект NumberFormatInfo или CultureInfo.The provider parameter is a IFormatProvider implementation, such as a NumberFormatInfo or CultureInfo object. Параметр provider предоставляет сведения, зависящие от языка и региональных параметров, используемые при анализе.The provider parameter supplies culture-specific information used in parsing. Если provider имеет null или не удается получить объект NumberFormatInfo, используются сведения о форматировании для текущего языка и региональных параметров.If provider is null or a NumberFormatInfo object cannot be obtained, the format information for the current culture is used.

Преобразование завершается неудачей, если параметр s null или не является числовым значением, параметр provider не дает NumberFormatInfo объекта, или параметр style не является сочетанием битовых флагов из перечисления NumberStyles.The conversion fails if the s parameter is null or not a numeric value, the provider parameter does not yield a NumberFormatInfo object, or the style parameter is not a combination of bit flags from the NumberStyles enumeration.

Обычно при передаче метода Double.TryParse строку, созданную путем вызова метода Double.ToString, возвращается исходное значение Double.Ordinarily, if you pass the Double.TryParse method a string that is created by calling the Double.ToString method, the original Double value is returned. Однако из-за потери точности значения могут не совпадать.However, because of a loss of precision, the values may not be equal. Кроме того, попытка выполнить синтаксический анализ строкового представления либо Double.MinValue, либо Double.MaxValue не дает круговой обработки.In addition, attempting to parse the string representation of either Double.MinValue or Double.MaxValue fails to round-trip. В .NET Framework и .NET Core 2,2 и предыдущих версиях она выдает исключение OverflowException.On .NET Framework and .NET Core 2.2 and previous versions, it throws an OverflowException. В .NET Core 3,0 и более поздних версиях он возвращает Double.NegativeInfinity при попытке выполнить синтаксический анализ MinValue или Double.PositiveInfinity при попытке проанализировать MaxValue.On .NET Core 3.0 and later versions, it returns Double.NegativeInfinity if you attempt to parse MinValue or Double.PositiveInfinity if you attempt to parse MaxValue. Ниже приведен пример.The following example provides an illustration.

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.            
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 и более ранних версиях, если s выходит за пределы диапазона Double типа данных, метод Double.TryParse(String, NumberStyles, IFormatProvider, Double) создает исключение OverflowException.On .NET Framework and .NET Core 2.2 and earlier versions, if s is out of range of the Double data type, the Double.TryParse(String, NumberStyles, IFormatProvider, Double) method throws an OverflowException.

В .NET Core 3,0 и более поздних версиях исключение не возникает, если s выходит за пределы диапазона Doubleного типа данных.On .NET Core 3.0 and later versions, no exception is thrown when s is out of range of the Double data type. В большинстве случаев Double.TryParse(String, NumberStyles, IFormatProvider, Double) метод вычисляет результат Double.PositiveInfinity или Double.NegativeInfinity.In most cases, the Double.TryParse(String, NumberStyles, IFormatProvider, Double) method calculates a result of Double.PositiveInfinity or Double.NegativeInfinity. Однако существует небольшой набор значений, которые считаются ближе к максимальному или минимальному значению Double, чем положительная или отрицательная бесконечность.However, there is a small set of values that are considered to be closer to the maximum or minimum values of Double than to positive or negative infinity. В таких случаях метод вычисляет результат Double.MaxValue или Double.MinValue.In those cases, the method calculates a result of Double.MaxValue or Double.MinValue.

Если в параметре s в ходе операции синтаксического анализа встречается разделитель, а применимые разделители денежных единиц или десятичного числа и групп совпадают, то операция синтаксического анализа предполагает, что разделитель является десятичным разделителем, а не разделителем групп.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. Дополнительные сведения о разделителях см. в разделе CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparatorи NumberGroupSeparator.For more information about separators, see CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparator, and NumberGroupSeparator.

Дополнительно

Применяется к