nfloat.Parse Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
Parse(String) |
Преобразует строковое представление числа в эквивалентное ему число двойной точности с плавающей запятой. |
Parse(String, NumberStyles) | |
Parse(String, IFormatProvider) |
Преобразует строковое представление числа, выраженное в заданном формате, связанном с языком и региональными параметрами, в эквивалентное ему число двойной точности с плавающей запятой. |
Parse(String, NumberStyles, IFormatProvider) |
Parse(String)
Преобразует строковое представление числа в эквивалентное ему число двойной точности с плавающей запятой.
public static nfloat Parse (string s);
static member Parse : string -> nfloat
Параметры
- s
- String
Строка, содержащая преобразуемое число.
Возвращаемое значение
Число с плавающей запятой, эквивалентное числовым значениям или символам, указанным в s
.
Комментарии
Параметр s
может содержать текущий язык и региональные параметры P:System.Globalization.NumberFormatInfo.PositiveInfinitySymbol, P:System.Globalization.NumberFormatInfo.NegativeInfinitySymbol, P:System.Globalization.NumberFormatInfo.NanSymbol, или строка в форме:
[ws] [sign] [целочисленные цифры[,]]целочисленные цифры[.[ fractional-digits]][E[sign]exponential-digits][ws]
Элементы в квадратных скобках ([и]) являются необязательными. Каждый из элементов описан в таблице ниже.
Элемент | Описание |
---|---|
ws | Ряд символов пробелов. |
sign | Символ отрицательного знака (-) или символ положительного знака (+). Можно использовать только ведущий знак. |
целочисленные цифры | Ряд цифр в диапазоне от 0 до 9, задающий неотъемлемую часть числа. Запуски целочисленных цифр можно секционировать символом разделителя группы. Например, в некоторых языках и региональных параметрах запятая (,) разделяет группы тысяч. Элемент целочисленных цифр может отсутствовать, если строка содержит элемент fractional-digits. |
, | Символ разделителя тысяч для конкретного языка и региональных параметров. |
. | Символ десятичной запятой для конкретного языка и региональных параметров. |
дробные цифры | Ряд цифр в диапазоне от 0 до 9, задающий дробную часть числа. |
E | Символ "e" или "E", который указывает, что значение представлено в экспоненциальной (научной) нотации. |
экспоненциальные цифры | Ряд цифр в диапазоне от 0 до 9, указывающий степень. |
Параметр s
интерпретируется с помощью сочетания F:System.Globalization.NumberStyles.Float и F:System.Globalization.NumberStyles.AllowThousands . Это означает, что пробелы и разделители тысяч разрешены, например, в то время как символы валюты — нет. Для более точного управления тем, какие элементы стиля разрешены в s
для успешного выполнения операции синтаксического анализа, вызовите M:System.Double.Parse(System.String,System.Globalization.NumberStyles) или M:System.Double.Parse(System.String,System.Globalization.NumberStyles, Метод System.IFormatProvider ).
Параметр s
интерпретируется с помощью сведений о форматировании в объекте T:System.Globalization.NumberFormatInfo , инициализированном для текущего языка и региональных параметров потока. Дополнительные сведения см. в разделе P:System.Globalization.NumberFormatInfo.CurrentInfo. Чтобы проанализировать строку, используя сведения о форматировании некоторых других языков и региональных параметров, вызовите M:System.Double.Parse(System.String,System.IFormatProvider) или M:System.Double.Parse(System.String,System.Globalization.NumberStyles,System.IFormatProvider).
Как правило, если передать метод M:System.Double.Parse* строку, созданную путем вызова метода M:System.Double.ToString*, возвращается исходное значение T:System.Double. Однако из-за потери точности значения могут быть не равными. Кроме того, попытка проанализировать строковое представление F:System.Double.MinValue или F:System.Double.MaxValue F:System.Double.MaxValue вызывает исключение T:System.OverflowException, как показано в следующем примере.
Справочник по коду: System.Double.Parse#3
Если во время операции синтаксического анализа в s
параметре обнаруживается разделитель, а применимые денежные или числовые десятичные и групповые разделители совпадают, операция синтаксического анализа предполагает, что разделитель является десятичным разделителем, а не разделителем группы. Дополнительные сведения о разделителях см. в разделе P:System.Globalization.NumberFormatInfo.CurrencyDecimalSeparator, P:System.Globalization.NumberFormatInfo.NumberDecimalSeparator, P: System.Globalization.NumberFormatInfo.CurrencyGroupSeparator и P:System.Globalization.NumberFormatInfo.NumberGroupSeparator.
Применяется к
Parse(String, NumberStyles)
public static nfloat Parse (string s, System.Globalization.NumberStyles style);
static member Parse : string * System.Globalization.NumberStyles -> nfloat
Параметры
- s
- String
- style
- NumberStyles
Возвращаемое значение
Применяется к
Parse(String, IFormatProvider)
Преобразует строковое представление числа, выраженное в заданном формате, связанном с языком и региональными параметрами, в эквивалентное ему число двойной точности с плавающей запятой.
public static nfloat Parse (string s, IFormatProvider provider);
static member Parse : string * IFormatProvider -> nfloat
Параметры
- s
- String
Строка, содержащая преобразуемое число.
- provider
- IFormatProvider
Объект, который предоставляет сведения о форматировании параметра s
в зависимости от языка и региональных параметров.
Возвращаемое значение
Число с плавающей запятой, эквивалентное числовым значениям или символам, указанным в s
.
Комментарии
Эта перегрузка Parse(String, IFormatProvider) метода обычно используется для преобразования текста, который можно отформатировать различными способами в nfloat значение. Например, его можно использовать для преобразования текста, введенного пользователем в текстовое поле HTML, в числовое значение.
Параметр s
интерпретируется с помощью сочетания F:System.Globalization.NumberStyles.Float и F:System.Globalization.NumberStyles.AllowThousands . Параметр s
может содержать P:System.Globalization.NumberFormatInfo.PositiveInfinitySymbol, P:System.Globalization.NumberFormatInfo.NegativeInfinitySymbol или P:System.Globalization.NumberFormatInfo.NaNSymbol для языка и региональных параметров определяется параметром provider
или может содержать строку в формате :
[ws] [sign]целочисленные цифры[.[ fractional-digits]][E[sign]exponential-digits][ws]
Необязательные элементы заключены в квадратные скобки ([ и ]). Элементы, содержащие термин "цифры", состоят из ряда числовых символов в диапазоне от 0 до 9.
Элемент | Описание |
---|---|
ws | Ряд символов пробелов. |
sign | Символ отрицательного знака (-) или символ положительного знака (+). |
целочисленные цифры | Ряд цифр в диапазоне от 0 до 9, задающий неотъемлемую часть числа. Запуски целочисленных цифр можно секционировать символом разделителя группы. Например, в некоторых языках и региональных параметрах запятая (,) разделяет группы тысяч. Элемент целочисленных цифр может отсутствовать, если строка содержит элемент fractional-digits. |
. | Символ десятичной запятой для конкретного языка и региональных параметров. |
дробные цифры | Ряд цифр в диапазоне от 0 до 9, задающий дробную часть числа. |
E | Символ "e" или "E", который указывает, что значение представлено в экспоненциальной (научной) нотации. |
экспоненциальные цифры | Ряд цифр в диапазоне от 0 до 9, указывающий степень. |
Параметр provider
является реализацией T:System.IFormatProvider , чей метод M:System.IFormatProvider.GetFormat(System.Type) возвращает объект T:System.Globalization.NumberFormatInfo , который предоставляет сведения о языке и региональных параметрах, используемые при интерпретации s
формата . Как правило, это объект T:System.Globalization.NumberFormatInfo или T:System.Globalization.CultureInfo . Если provider
имеет значение NULL или не удается получить T T:System.Globalization.NumberFormatInfo , используются сведения о форматировании для текущего системного языка и региональных параметров.
Обычно при передаче метода M:System.nfloat.Parse* строки, созданной путем вызова метода M:System.nfloat.ToString* , возвращается исходное nfloat значение. Однако из-за потери точности значения могут быть не равными. Кроме того, при попытке проанализировать строковое представление MinValue или MaxValue вызывается T:System.OverflowException.
Если во время операции синтаксического анализа в s
параметре обнаруживается разделитель, а применимые денежные или числовые десятичные и групповые разделители совпадают, операция синтаксического анализа предполагает, что разделитель является десятичным разделителем, а не разделителем группы. Дополнительные сведения о разделителях см. в разделе P:System.Globalization.NumberFormatInfo.CurrencyDecimalSeparator, P:System.Globalization.NumberFormatInfo.NumberDecimalSeparator, P: System.Globalization.NumberFormatInfo.CurrencyGroupSeparator и P:System.Globalization.NumberFormatInfo.NumberGroupSeparator.
Применяется к
Parse(String, NumberStyles, IFormatProvider)
public static nfloat Parse (string s, System.Globalization.NumberStyles style, IFormatProvider provider);
static member Parse : string * System.Globalization.NumberStyles * IFormatProvider -> nfloat
Параметры
- s
- String
- style
- NumberStyles
- provider
- IFormatProvider