tryparse c что это
Int64.Try Parse Метод
Определение
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Преобразует строковое представление числа в эквивалентное ему 64-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование.
Перегрузки
Преобразует строковое представление числа в эквивалентное ему 64-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование.
Преобразует представление числа в виде диапазона в эквивалентное ему 64-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование.
Преобразует строковое представление числа в формате, соответствующем языку и региональным параметрам, в эквивалентное ему 64-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование.
Преобразует представление числа в виде диапазона в указанном стиле и формате, соответствующем языку и региональным параметрам, в эквивалентное ему 64-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование.
TryParse(String, Int64)
Преобразует строковое представление числа в эквивалентное ему 64-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование.
Параметры
Строка, содержащая преобразуемое число.
Возвращаемое значение
Примеры
В следующем примере вызывается Int64.TryParse(String, Int64) метод с количеством различных строковых значений.
Некоторые строки, которые метод не TryParse(String, Int64) может преобразовать в этом примере:
«9432.0». Преобразование завершается неудачей, поскольку строка не может содержать десятичный разделитель; Он должен содержать только цифры целой части.
«16,667». Преобразование завершается неудачей, поскольку строка не может содержать разделители групп; Он должен содержать только цифры целой части.
«01FA». Преобразование завершается неудачей, поскольку строка не может содержать шестнадцатеричные цифры; Он должен содержать только десятичные цифры.
Комментарии
TryParseМетод похож на Parse метод, за исключением того, что TryParse метод не создает исключение, если преобразование завершается неудачей. Это исключает необходимость использования обработки исключений для проверки FormatException в случае, если событие s является недопустимым и его невозможно успешно проанализировать.
s Параметр содержит номер формы:
Протокол [знак] цифры [ws]
Элементы в квадратных скобках ([и]) являются необязательными. Каждый из элементов описан в таблице ниже.
| Элемент | Описание |
|---|---|
| ws | Необязательный пробел. |
| sign | Необязательный знак. |
| digits | Последовательность цифр в диапазоне от 0 до 9. |
s Параметр анализируется с помощью сведений о форматировании в NumberFormatInfo объекте, инициализированном для текущего языка и региональных параметров системы. Для получения дополнительной информации см. CurrentInfo.
Эта перегрузка TryParse метода интерпретирует все цифры в s параметре как десятичные цифры. Чтобы проанализировать строковое представление шестнадцатеричного числа, вызовите TryParse(String, NumberStyles, IFormatProvider, Int64) перегрузку.
См. также раздел
Применяется к
Преобразует представление числа в виде диапазона в эквивалентное ему 64-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование.
Параметры
Диапазон, содержащий символы, которые представляют преобразуемое число.
Возвращаемое значение
Применяется к
TryParse(String, NumberStyles, IFormatProvider, Int64)
Преобразует строковое представление числа в формате, соответствующем языку и региональным параметрам, в эквивалентное ему 64-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование.
Параметры
Объект, который предоставляет сведения о форматировании параметра s в зависимости от языка и региональных параметров.
Возвращаемое значение
Исключения
style не является значением NumberStyles.
-или- style не является сочетанием значений AllowHexSpecifier и HexNumber.
Примеры
В следующем примере вызывается TryParse(String, NumberStyles, IFormatProvider, Int64) метод с несколькими строками и NumberStyles значениями.
Комментарии
TryParseМетод похож на Parse метод, за исключением того, что TryParse метод не создает исключение, если преобразование завершается неудачей. Это исключает необходимость использования обработки исключений для проверки FormatException в случае, если событие s является недопустимым и его невозможно успешно проанализировать.
style Параметр определяет элементы стиля (например, пробелы или положительный или отрицательный знак), допустимые в s параметре для успешной операции синтаксического анализа. Он должен представлять собой сочетание битовых флагов из NumberStyles перечисления. В зависимости от значения style s параметр может включать следующие элементы:
Протокол [$] писать [цифры,] цифры [.fractional_digits] [e [sign] exponential_digits] [ws]
Элементы в квадратных скобках ([и]) являются необязательными. Каждый из элементов описан в таблице ниже.
Все завершающие символы NUL (U + 0000) в s игнорируются операцией синтаксического анализа, независимо от значения style аргумента.
Enum. Try Parse Метод
Определение
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Преобразует строковое представление имени или числового значения одной или нескольких перечислимых констант в эквивалентный перечислимый объект. Возвращаемое значение указывает, успешно ли выполнено преобразование.
Перегрузки
Преобразует представление числа символов имени или числового значения одной или нескольких перечислимых констант в эквивалентный перечисляемый объект.
Преобразует строковое представление имени или числового значения одной или нескольких перечислимых констант в эквивалентный перечислимый объект.
Преобразует представление числа символов имени или числового значения одной или нескольких перечислимых констант в эквивалентный перечисляемый объект. Параметр указывает, учитывается ли в операции регистр.
Преобразует строковое представление имени или числового значения одной или нескольких перечислимых констант в эквивалентный перечислимый объект.
Преобразует строковое представление имени или числового значения одной или нескольких перечислимых констант в эквивалентный перечислимый объект.
Преобразует строковое представление имени или числового значения одной или нескольких перечислимых констант в эквивалентный перечислимый объект. Возвращаемое значение указывает, успешно ли выполнено преобразование.
Преобразует строковое представление имени или числового значения одной или нескольких перечислимых констант в эквивалентный перечислимый объект. Параметр указывает, учитывается ли в операции регистр. Возвращаемое значение указывает, успешно ли выполнено преобразование.
Преобразует строковое представление имени или числового значения одной или нескольких перечислимых констант в эквивалентный перечислимый объект. Параметр указывает, учитывается ли в операции регистр. Возвращаемое значение указывает, успешно ли выполнено преобразование.
Преобразует представление числа символов имени или числового значения одной или нескольких перечислимых констант в эквивалентный перечисляемый объект.
Параметры
Тип перечисления, используемый для разбора.
Представление диапазона для имени или числового значения одной или нескольких перечислимых констант.
Возвращаемое значение
Применяется к
TryParse(Type, String, Object)
Преобразует строковое представление имени или числового значения одной или нескольких перечислимых констант в эквивалентный перечислимый объект.
Параметры
Тип перечисления, используемый для разбора.
Строковое представление имени или числового значения одной или нескольких перечислимых констант.
Возвращаемое значение
Применяется к
Преобразует представление числа символов имени или числового значения одной или нескольких перечислимых констант в эквивалентный перечисляемый объект. Параметр указывает, учитывается ли в операции регистр.
Параметры
Тип перечисления, используемый для разбора.
Представление диапазона для имени или числового значения одной или нескольких перечислимых констант.
Значение true для чтения enumType в режиме без учета регистра; значение false для чтения enumType в режиме с учетом регистра.
Возвращаемое значение
Применяется к
TryParse(Type, String, Boolean, Object)
Преобразует строковое представление имени или числового значения одной или нескольких перечислимых констант в эквивалентный перечислимый объект.
Параметры
Тип перечисления, используемый для разбора.
Строковое представление имени или числового значения одной или нескольких перечислимых констант.
Значение true для чтения value в режиме без учета регистра; значение false для чтения value в режиме с учетом регистра.
Возвращаемое значение
Применяется к
Преобразует строковое представление имени или числового значения одной или нескольких перечислимых констант в эквивалентный перечислимый объект.
Параметры типа
Параметры
Представление диапазона для имени или числового значения одной или нескольких перечислимых констант.
Возвращаемое значение
Исключения
TEnum не является типом перечисления.
Применяется к
TryParse (String, TEnum)
Преобразует строковое представление имени или числового значения одной или нескольких перечислимых констант в эквивалентный перечислимый объект. Возвращаемое значение указывает, успешно ли выполнено преобразование.
Параметры типа
Параметры
Чувствительное к регистру строковое представление имени перечисления или базового значения для преобразования.
Возвращаемое значение
Исключения
TEnum не является типом перечисления.
Примеры
В следующем примере определяется Colors перечисление, вызывается TryParse (String, TEnum) метод для преобразования строк в соответствующие им значения перечисления и вызывается IsDefined метод, чтобы гарантировать, что определенные целочисленные значения являются базовыми значениями в Colors перечислении.
Комментарии
TryParse (String, TEnum) функция идентична Parse(Type, String) методу, за исключением того, что вместо создания исключения оно возвращается в false случае сбоя преобразования. Он устраняет необходимость в обработке исключений при анализе строкового представления значения перечисления.
См. также раздел
Применяется к
TryParse (String, Boolean, TEnum)
Преобразует строковое представление имени или числового значения одной или нескольких перечислимых констант в эквивалентный перечислимый объект. Параметр указывает, учитывается ли в операции регистр. Возвращаемое значение указывает, успешно ли выполнено преобразование.
Параметры типа
Параметры
Строковое представление имени перечисления или базового значения для преобразования.
Возвращаемое значение
Исключения
TEnum не является типом перечисления.
Примеры
В следующем примере определяется Colors перечисление, вызывается TryParse (String, Boolean, TEnum) метод для преобразования строк в соответствующие им значения перечисления и вызывается IsDefined метод, чтобы гарантировать, что определенные целочисленные значения являются базовыми значениями в Colors перечислении. TryParse (String, Boolean, TEnum)При попытке преобразовать строковые представления именованных констант в эквивалентные им значения перечисления метод использует сравнение без учета регистра.
Комментарии
TryParse (String, Boolean, TEnum) функция идентична Parse(Type, String, Boolean) методу, за исключением того, что вместо создания исключения оно возвращается в false случае сбоя преобразования. Он устраняет необходимость в обработке исключений при анализе строкового представления значения перечисления.
SByte. Try Parse Метод
Определение
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Преобразует строковое представление числа в эквивалентное ему 8-битовое целое число со знаком. Возвращает код, позволяющий определить, успешно ли выполнено преобразование.
Перегрузки
Предпринимает попытку преобразования строкового представления числа в его эквивалент типа SByte и возвращает значение, позволяющее определить, успешно ли выполнено преобразование.
Пытается преобразовать представление числа в виде диапазона в его эквивалент типа SByte и возвращает значение, которое указывает на то, успешно ли выполнено преобразование.
Предпринимает попытку преобразования числа в формате, который определяется заданным стилем и языком и региональными параметрами, в эквивалент типа SByte и возвращает значение, определяющее, успешно ли выполнено преобразование.
Пытается преобразовать представление числа в виде диапазона в указанном стиле и формате для определенного языка и региональных параметров в его эквивалент типа SByte и возвращает значение, которое указывает на то, успешно ли выполнено преобразование.
TryParse(String, SByte)
Этот API несовместим с CLS.
Предпринимает попытку преобразования строкового представления числа в его эквивалент типа SByte и возвращает значение, позволяющее определить, успешно ли выполнено преобразование.
Параметры
Строка, содержащая преобразуемое число.
Возвращаемое значение
Примеры
В следующем примере предпринимается попытка преобразовать строки в массиве в SByte значения, вызвав TryParse(String, SByte) метод.
Комментарии
SByte.TryParse(String, SByte)Метод похож на SByte.Parse(String) метод, за исключением того, что он не создает исключение, если преобразование завершается неудачей. Этот метод устраняет необходимость использования обработки исключений для проверки, FormatException Если value является недопустимой и не может быть успешно проанализирована.
s Параметр должен быть строковым представлением десятичного числа в следующей форме:
Элементы в квадратных скобках ([и]) являются необязательными. Каждый из элементов описан в таблице ниже.
| Элемент | Описание |
|---|---|
| ws | Необязательный пробел. |
| sign | Необязательный знак. Допустимые символы знака определяются NumberFormatInfo.NegativeSign свойствами и NumberFormatInfo.PositiveSign текущего языка и региональных параметров. |
| digits | Последовательность десятичных цифр в диапазоне от 0 до 9. |
Строка, заданная value параметром, не может содержать разделители групп или десятичный разделитель и не может иметь дробную часть.
s Параметр анализируется с помощью сведений о форматировании в NumberFormatInfo объекте для текущего языка и региональных параметров. Для получения дополнительной информации см. NumberFormatInfo.CurrentInfo.
Эта перегрузка интерпретирует все цифры в value параметре как десятичные цифры. Чтобы проанализировать строковое представление шестнадцатеричного числа, вызовите TryParse(String, NumberStyles, IFormatProvider, SByte) перегрузку.
См. также раздел
Применяется к
Этот API несовместим с CLS.
Пытается преобразовать представление числа в виде диапазона в его эквивалент типа SByte и возвращает значение, которое указывает на то, успешно ли выполнено преобразование.
Параметры
Диапазон, содержащий символы, которые представляют преобразуемое число.
Возвращаемое значение
Применяется к
TryParse(String, NumberStyles, IFormatProvider, SByte)
Этот API несовместим с CLS.
Альтернативный вариант, совместимый с CLS System.Int16.TryParse(String, Int16)
Предпринимает попытку преобразования числа в формате, который определяется заданным стилем и языком и региональными параметрами, в эквивалент типа SByte и возвращает значение, определяющее, успешно ли выполнено преобразование.
Параметры
Строка, представляющая преобразуемое число.
Объект, который предоставляет сведения о форматировании параметра s в зависимости от языка и региональных параметров.
Возвращаемое значение
Исключения
style не является значением NumberStyles.
-или- style не является сочетанием значений AllowHexSpecifier и HexNumber.
Примеры
В следующем примере вызывается TryParse(String, NumberStyles, IFormatProvider, SByte) метод с несколькими строками и NumberStyles значениями.
Комментарии
TryParse(String, NumberStyles, IFormatProvider, SByte)Метод похож на Parse(String, NumberStyles, IFormatProvider) метод, за исключением того, что он не создает исключение, если преобразование завершается неудачей. Этот метод устраняет необходимость использования обработки исключений для проверки, FormatException Если value является недопустимой и не может быть успешно проанализирована.
style Параметр определяет элементы стиля (например, пробелы или положительный или отрицательный знак), допустимые в value параметре для успешной операции синтаксического анализа. Он должен представлять собой сочетание битовых флагов из NumberStyles перечисления. В зависимости от значения style value параметр может включать следующие элементы:
Элементы в квадратных скобках ([и]) являются необязательными. Каждый из элементов описан в таблице ниже.
Все завершающие символы NUL (U + 0000) в s игнорируются операцией синтаксического анализа, независимо от значения style аргумента.
Если value является строковым представлением шестнадцатеричного числа, ему не может предшествовать любое декорирование (например, 0x или &h ), которое отличает его как шестнадцатеричное число. Это приводит к сбою преобразования.
CultureInfoОбъект, представляющий язык и региональные параметры, которые предоставляют сведения о форматировании. Его GetFormat метод возвращает NumberFormatInfo объект, предоставляющий сведения о форматировании числовых значений для этого языка и региональных параметров.
NumberFormatInfoОбъект, предоставляющий сведения о форматировании чисел. (Его реализация GetFormat просто возвращает сам себя.)
Int32.Try Parse Метод
Определение
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Преобразует строковое представление числа в эквивалентное ему 32-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнена операция.
Перегрузки
Преобразует строковое представление числа в эквивалентное ему 32-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование.
Преобразует представление числа в виде диапазона в формате, соответствующем стилю, языку и региональным параметрам, в эквивалентное ему 32-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование.
Преобразует строковое представление числа в формате, соответствующем языку и региональным параметрам, в эквивалентное ему 32-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование.
Преобразует представление числа в виде диапазона в формате, соответствующем стилю, языку и региональным параметрам, в эквивалентное ему 32-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование.
TryParse(String, Int32)
Преобразует строковое представление числа в эквивалентное ему 32-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование.
Параметры
Строка, содержащая преобразуемое число.
Возвращаемое значение
Примеры
В следующем примере вызывается Int32.TryParse(String, Int32) метод с количеством различных строковых значений.
Некоторые строки, которые метод не TryParse(String, Int32) может преобразовать в этом примере:
«9432.0». Преобразование завершается неудачей, поскольку строка не может содержать десятичный разделитель; Он должен содержать только цифры целой части.
«16,667». Преобразование завершается неудачей, поскольку строка не может содержать разделители групп; Он должен содержать только цифры целой части.
«01FA». Преобразование завершается неудачей, поскольку строка не может содержать шестнадцатеричные цифры; Он должен содержать только десятичные цифры.
Комментарии
TryParseМетод похож на Parse метод, за исключением того, что TryParse метод не создает исключение, если преобразование завершается неудачей. Это исключает необходимость использования обработки исключений для проверки FormatException в случае, если событие s является недопустимым и его невозможно успешно проанализировать.
s Параметр содержит номер формы:
Протокол [знак] цифры [ws]
Элементы в квадратных скобках ([и]) являются необязательными. Каждый из элементов описан в таблице ниже.
| Элемент | Описание |
|---|---|
| ws | Необязательный пробел. |
| sign | Необязательный знак. |
| digits | Последовательность цифр в диапазоне от 0 до 9. |
s Параметр анализируется с помощью сведений о форматировании в NumberFormatInfo объекте, инициализированном для текущего языка и региональных параметров системы. Для получения дополнительной информации см. CurrentInfo.
Эта перегрузка TryParse метода интерпретирует все цифры в s параметре как десятичные цифры. Чтобы проанализировать строковое представление шестнадцатеричного числа, вызовите Int32.TryParse(String, NumberStyles, IFormatProvider, Int32) перегрузку.
См. также раздел
Применяется к
Преобразует представление числа в виде диапазона в формате, соответствующем стилю, языку и региональным параметрам, в эквивалентное ему 32-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование.
Параметры
Диапазон, содержащий символы, которые представляют преобразуемое число.
Возвращаемое значение
Применяется к
TryParse(String, NumberStyles, IFormatProvider, Int32)
Преобразует строковое представление числа в формате, соответствующем языку и региональным параметрам, в эквивалентное ему 32-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование.
Параметры
Объект, который предоставляет сведения о форматировании параметра s в зависимости от языка и региональных параметров.
Возвращаемое значение
Исключения
style не является значением NumberStyles.
-или- style не является сочетанием значений AllowHexSpecifier и HexNumber.
Примеры
В следующем примере вызывается Int32.TryParse(String, NumberStyles, IFormatProvider, Int32) метод с несколькими строками и NumberStyles значениями.
Комментарии
TryParseМетод похож на Parse метод, за исключением того, что TryParse метод не создает исключение, если преобразование завершается неудачей. Это исключает необходимость использования обработки исключений для проверки FormatException в случае, если событие s является недопустимым и его невозможно успешно проанализировать.
style Параметр определяет элементы стиля (например, пробелы или положительный или отрицательный знак), допустимые в s параметре для успешной операции синтаксического анализа. Он должен представлять собой сочетание битовых флагов из NumberStyles перечисления. В зависимости от значения style s параметр может включать следующие элементы:
Протокол [$] писать [цифры,] цифры [.fractional_digits] [e [знак] цифры] [ws]
Или, если style параметр включает AllowHexSpecifier :
Элементы в квадратных скобках ([и]) являются необязательными. Каждый из элементов описан в таблице ниже.
Все завершающие символы NUL (U + 0000) в s игнорируются операцией синтаксического анализа, независимо от значения style аргумента.