Single.TryParse Single.TryParse Single.TryParse Single.TryParse Method

Определение

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

Перегрузки

TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Single) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Single) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Single) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Single)
TryParse(String, Single) TryParse(String, Single) TryParse(String, Single) TryParse(String, Single)

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

TryParse(ReadOnlySpan<Char>, Single) TryParse(ReadOnlySpan<Char>, Single) TryParse(ReadOnlySpan<Char>, Single) TryParse(ReadOnlySpan<Char>, Single)
TryParse(String, NumberStyles, IFormatProvider, Single) TryParse(String, NumberStyles, IFormatProvider, Single) TryParse(String, NumberStyles, IFormatProvider, Single) TryParse(String, NumberStyles, IFormatProvider, Single)

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

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

public:
 static bool TryParse(ReadOnlySpan<char> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] float % result);
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider provider, out float result);
static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * single -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), style As NumberStyles, provider As IFormatProvider, ByRef result As Single) As Boolean

Параметры

Возвраты

TryParse(String, Single) TryParse(String, Single) TryParse(String, Single) TryParse(String, Single)

Преобразует строковое представление числа в эквивалентное ему число с плавающей запятой одиночной точности.Converts the string representation of a number to its single-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] float % result);
public static bool TryParse (string s, out float result);
static member TryParse : string * single -> bool
Public Shared Function TryParse (s As String, ByRef result As Single) As Boolean

Параметры

s
String String String String

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

result
Single Single Single Single

Когда этот метод возвращает значение, оно содержит эквивалент числового значения или символа, содержащегося в параметре s, представленный в виде числа с плавающей запятой одиночной точности, если преобразование прошло успешно, или нуль, если произошел сбой преобразования.When this method returns, contains single-precision floating-point number equivalent to the numeric value or symbol contained in s, if the conversion succeeded, or zero if the conversion failed. Преобразование завершается сбоем, если значение параметра s равно null или Empty, не является числом допустимого формата или представляет число меньше MinValue или больше MaxValue.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 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, Single) метод используется для преобразования строковых представлений числовых значений в Single значения.The following example uses the TryParse(String, Single) method to convert the string representations of numeric values to Single values. Предполагается, что en-US является текущим языком и региональными параметрами.It assumes that en-US is the current culture.

string value;
float number;

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

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

// Parse a negative integer value.
value = "-168934617882109132";
if (Single.TryParse(value, out number))
   Console.WriteLine(number);
else
   Console.WriteLine("Unable to parse '{0}'.", value);   
// The example displays the following output:
//       1643.57
//       Unable to parse '$1,643.57'.
//       -164300
//       -1.68934617882109E+17
Dim value As String
Dim number As Single

' Parse a floating-point value with a thousands separator.
value = "1,643.57"
If Single.TryParse(value, number) Then
   Console.WriteLine(number)
Else
   Console.WriteLine("Unable to parse '{0}'.", value)      
End If   

' Parse a floating-point value with a currency symbol and a 
' thousands separator.
value = "$1,643.57"
If Single.TryParse(value, number) Then
   Console.WriteLine(number)  
Else
   Console.WriteLine("Unable to parse '{0}'.", value)   
End If

' Parse value in exponential notation.
value = "-1.643e6"
If Single.TryParse(value, number)
   Console.WriteLine(number)
Else
   Console.WriteLine("Unable to parse '{0}'.", value)   
End If

' Parse a negative integer number.
value = "-168934617882109132"
If Single.TryParse(value, number)
   Console.WriteLine(number)
Else
   Console.WriteLine("Unable to parse '{0}'.", value)   
End If
' The example displays the following output:
'       1643.57
'       Unable to parse '$1,643.57'.
'       -1643000
'       -1.68934617882109E+17

Комментарии

Эта перегрузка отличается от Single.Parse(String) метода путем возвращения логического значения, которое указывает, завершилась ли операция синтаксического анализа, а не возвращать проанализированное числовое значение.This overload differs from the Single.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.

Параметр может содержать PositiveInfinitySymbol, NegativeInfinitySymbol ,NaNSymbol (сравнение строк учитывает регистр) или строку в формате: sThe s parameter can contain PositiveInfinitySymbol, NegativeInfinitySymbol, 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.

Параметр интерпретируется с помощью сочетания NumberStyles.Float флагов и NumberStyles.AllowThousands. sThe s parameter is interpreted 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, TryParse(String, NumberStyles, IFormatProvider, Single) используйте перегрузку метода.To explicitly define the elements (such as currency symbols, thousands separators, and white space) that can be present in s, use the TryParse(String, NumberStyles, IFormatProvider, Single) method overload.

Параметр анализируется с помощью сведений о форматировании NumberFormatInfo в объекте, инициализированном для текущего языка и региональных параметров системы. sThe 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. Чтобы выполнить синтаксический анализ строки, используя сведения о форматировании некоторых других указанных региональных TryParse(String, NumberStyles, IFormatProvider, Single) параметров, используйте перегрузку метода.To parse a string using the formatting information of some other specified culture, use the TryParse(String, NumberStyles, IFormatProvider, Single) method overload.

Обычно, если передать Single.TryParse методу строку, созданную путем Single.ToString вызова метода, возвращается исходное Single значение.Ordinarily, if you pass the Single.TryParse method a string that is created by calling the Single.ToString method, the original Single value is returned. Однако из-за потери точности значения могут не совпадать.However, because of a loss of precision, the values may not be equal.

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

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

TryParse(ReadOnlySpan<Char>, Single) TryParse(ReadOnlySpan<Char>, Single) TryParse(ReadOnlySpan<Char>, Single) TryParse(ReadOnlySpan<Char>, Single)

public:
 static bool TryParse(ReadOnlySpan<char> s, [Runtime::InteropServices::Out] float % result);
public static bool TryParse (ReadOnlySpan<char> s, out float result);
static member TryParse : ReadOnlySpan<char> * single -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As Single) As Boolean

Параметры

Возвраты

TryParse(String, NumberStyles, IFormatProvider, Single) TryParse(String, NumberStyles, IFormatProvider, Single) TryParse(String, NumberStyles, IFormatProvider, Single) TryParse(String, NumberStyles, IFormatProvider, Single)

Преобразует строковое представление числа в указанном стиле и с использованием формата, соответствующего данному языку и региональным параметрам, в эквивалентное ему число с плавающей запятой одиночной точности.Converts the string representation of a number in a specified style and culture-specific format to its single-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] float % result);
public static bool TryParse (string s, System.Globalization.NumberStyles style, IFormatProvider provider, out float result);
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * single -> bool
Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As Single) As Boolean

Параметры

s
String String String String

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

style
NumberStyles NumberStyles NumberStyles NumberStyles

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

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

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

result
Single Single Single Single

Когда этот метод возвращает значение, оно содержит эквивалент числового значения или символа, содержащегося в параметре s, представленный в виде числа с плавающей запятой одиночной точности, если преобразование прошло успешно, или нуль, если произошел сбой преобразования.When this method returns, contains the single-precision floating-point number equivalent to the numeric value or symbol contained in s, if the conversion succeeded, or zero if the conversion failed. Преобразование завершается неудачно, если параметр s имеет значение null или Empty, не является значением в формате, совместимом с параметром style, представляет число меньше MinValue или больше MaxValue, либо если style не является допустимой комбинацией перечисленных констант NumberStyles.The conversion fails if the s parameter is null or Empty, is not in a format compliant with style, represents a number less than MinValue or greater than MaxValue, or if style is not a valid combination of NumberStyles enumerated constants. Этот параметр передается неинициализированным; любое значение, первоначально предоставленное в 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 is the AllowHexSpecifier value.

Примеры

В следующем примере демонстрируется использование Single.TryParse(String, NumberStyles, IFormatProvider, Single) метода для синтаксического анализа строкового представления чисел с определенным стилем и форматирования с использованием соглашений определенного языка и региональных параметров.The following example demonstrates the use of the Single.TryParse(String, NumberStyles, IFormatProvider, Single) 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;
System.Globalization.NumberStyles style;
System.Globalization.CultureInfo culture;
float number;

// Parse currency value using en-GB culture.
value = "£1,097.63";
style = System.Globalization.NumberStyles.Number | 
        System.Globalization.NumberStyles.AllowCurrencySymbol;
culture = System.Globalization.CultureInfo.CreateSpecificCulture("en-GB");
if (Single.TryParse(value, style, culture, out number))
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
   Console.WriteLine("Unable to convert '{0}'.", value);

value = "1345,978";
style = System.Globalization.NumberStyles.AllowDecimalPoint;
culture = System.Globalization.CultureInfo.CreateSpecificCulture("fr-FR");
if (Single.TryParse(value, style, culture, out number))
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
   Console.WriteLine("Unable to convert '{0}'.", value);

value = "1.345,978";
style = System.Globalization.NumberStyles.AllowDecimalPoint | 
        System.Globalization.NumberStyles.AllowThousands;
culture = System.Globalization.CultureInfo.CreateSpecificCulture("es-ES");
if (Single.TryParse(value, style, culture, out number))
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
   Console.WriteLine("Unable to convert '{0}'.", value);

value = "1 345,978";
if (Single.TryParse(value, style, culture, out number))
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
   Console.WriteLine("Unable to convert '{0}'.", value);
// The example displays the following output:
//       Converted '£1,097.63' to 1097.63.
//       Converted '1345,978' to 1345.978.
//       Converted '1.345,978' to 1345.978.
//       Unable to convert '1 345,978'.
Dim value As String
Dim style As System.Globalization.NumberStyles
Dim culture As System.Globalization.CultureInfo
Dim number As Single

' Parse currency value using en-GB culture.
value = "£1,097.63"
style = System.Globalization.NumberStyles.Number Or _
        System.Globalization.NumberStyles.AllowCurrencySymbol
culture = System.Globalization.CultureInfo.CreateSpecificCulture("en-GB")
If Single.TryParse(value, style, culture, number) Then
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
   Console.WriteLine("Unable to convert '{0}'.", value)
End If    

value = "1345,978"
style = System.Globalization.NumberStyles.AllowDecimalPoint
culture = System.Globalization.CultureInfo.CreateSpecificCulture("fr-FR")
If Single.TryParse(value, style, culture, number) Then
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
   Console.WriteLine("Unable to convert '{0}'.", value)
End If    

value = "1.345,978"
style = System.Globalization.NumberStyles.AllowDecimalPoint Or _
        System.Globalization.NumberStyles.AllowThousands
culture = System.Globalization.CultureInfo.CreateSpecificCulture("es-ES")
If Single.TryParse(value, style, culture, number) Then
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
   Console.WriteLine("Unable to convert '{0}'.", value)
End If    

value = "1 345,978"
If Single.TryParse(value, style, culture, number) Then
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
   Console.WriteLine("Unable to convert '{0}'.", value)
End If    
' The example displays the following output:
'       Converted '£1,097.63' to 1097.63.
'       Converted '1345,978' to 1345.978.
'       Converted '1.345,978' to 1345.978.
'       Unable to convert '1 345,978'.

Комментарии

Эта перегрузка отличается от Parse(String, NumberStyles, IFormatProvider) метода путем возвращения логического значения, которое указывает, завершилась ли операция синтаксического анализа, а не возвращать проанализированное числовое значение.This overload differs from the Parse(String, NumberStyles, IFormatProvider) 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 параметра для выполнения операции синтаксического анализа. styleThe 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:

PositiveInfinitySymbol NegativeInfinitySymbolПараметр может содержать, provider, дляязыкаирегиональныхпараметров,указанныхвNaNSymbol. sThe s parameter can contain PositiveInfinitySymbol, NegativeInfinitySymbol, 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 или NumberFormatInfo.CurrencyPositivePattern объекта, возвращаемыми 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 , NumberStyles.AllowCurrencySymbol если style включает флаг.The currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign Необязательный знак.An optional sign. Знак может s присутствовать в начале, если style включает NumberStyles.AllowLeadingSign флаг, s и может NumberStyles.AllowTrailingSign находиться в конце, если style включает флаг.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 присутствовать в NumberStyles.AllowDecimalPoint , если style включает флаг.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. Параметр может представлять число в экспоненциальной нотации, NumberStyles.AllowExponent если стиль включает флаг. sThe 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 стилю) всегда будет успешно проанализирована.A string with digits only (which corresponds to the NumberStyles.None style) always parses successfully. Остальные 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.

Параметр — это GetFormatреализация, метод которой возвращает объект,предоставляющийсведенияобособенностяхформатирования,связанныхсязыкомирегиональнымипараметрами.NumberFormatInfo IFormatProvider providerThe provider parameter is an IFormatProvider implementation whose GetFormat method returns a NumberFormatInfo object that provides culture-specific formatting information. Type provider GetFormat При вызове метода он вызывает метод параметраNumberFormatInfo и передает ему объект, представляющий тип. TryParse(String, NumberStyles, IFormatProvider, Single)When the TryParse(String, NumberStyles, IFormatProvider, Single) method is invoked, it calls the provider parameter's GetFormat method and passes it a Type object that represents the NumberFormatInfo type. Затем метод возвращает объект, предоставляющий сведения s о формате параметра. NumberFormatInfo GetFormatThe GetFormat method then returns the NumberFormatInfo object that provides information about the format of the s parameter. Существует три способа использования provider параметра для предоставления сведений о пользовательском форматировании операции синтаксического анализа:There are three ways to use the provider parameter to supply custom formatting information to the parse operation:

  • Можно передать CultureInfo объект, представляющий язык и региональные параметры, которые предоставляют сведения о форматировании.You can pass a CultureInfo object that represents the culture that supplies formatting information. Его GetFormat методNumberFormatInfo возвращает объект, предоставляющий сведения о форматировании числовых значений для этого языка и региональных параметров.Its GetFormat method returns the NumberFormatInfo object that provides numeric formatting information for that culture.

  • Можно передать фактический NumberFormatInfo объект, предоставляющий сведения о форматировании чисел.You can pass the actual NumberFormatInfo object that provides numeric formatting information. (Его реализация GetFormat просто возвращает сам себя.)(Its implementation of GetFormat just returns itself.)

  • Можно передать пользовательский объект, реализующий интерфейс IFormatProvider.You can pass a custom object that implements IFormatProvider. Его GetFormat метод создает экземпляр и NumberFormatInfo возвращает объект, предоставляющий сведения о форматировании.Its GetFormat method instantiates and returns the NumberFormatInfo object that provides formatting information.

Если provider имеет nullзначение, форматирование s интерпретируется на основе NumberFormatInfo объекта текущего языка и региональных параметров.If provider is null, the formatting of s is interpreted based on the NumberFormatInfo object of the current culture.

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

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

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