Tryparse c что это
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 аргумента.
Int16.Try Parse Метод
Определение
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Преобразует строковое представление числа в эквивалентное ему 16-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование.
Перегрузки
Преобразует строковое представление числа в эквивалентное ему 16-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование.
Преобразует представление числа в виде диапазона в указанном стиле и формате, соответствующем языку и региональным параметрам, в эквивалентное ему 16-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование.
Преобразует строковое представление числа в формате, соответствующем языку и региональным параметрам, в эквивалентное ему 16-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование.
Преобразует представление числа в виде диапазона в указанном стиле и формате, соответствующем языку и региональным параметрам, в эквивалентное ему 16-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование.
TryParse(String, Int16)
Преобразует строковое представление числа в эквивалентное ему 16-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование.
Параметры
Строка, содержащая преобразуемое число.
Возвращаемое значение
Примеры
В следующем примере вызывается Int16.TryParse(String, Int16) метод с количеством различных строковых значений.
Некоторые строки, которые метод не TryParse(String, Int16) может преобразовать в этом примере:
«9432.0». Преобразование завершается неудачей, поскольку строка не может содержать десятичный разделитель; Он должен содержать только цифры целой части.
«16,667». Преобразование завершается неудачей, поскольку строка не может содержать разделители групп; Он должен содержать только цифры целой части.
«01FA». Преобразование завершается неудачей, поскольку строка не может содержать шестнадцатеричные цифры; Он должен содержать только десятичные цифры.
Комментарии
Int16.TryParse(String, Int16)Метод отличается от Int16.Parse(String) метода, возвращая логическое значение, которое указывает, завершилась ли операция синтаксического анализа, а не возвращать проанализированное Int16 значение. Это исключает необходимость использования обработки исключений для проверки FormatException в случае, если событие s является недопустимым и его невозможно успешно проанализировать.
s Параметр должен быть строковым представлением числа в виде:
Протокол [знак] цифры [ws]
Элементы в квадратных скобках ([и]) являются необязательными. Каждый из элементов описан в таблице ниже.
| Элемент | Описание |
|---|---|
| ws | Необязательный пробел. |
| sign | Необязательный знак. |
| digits | Последовательность цифр в диапазоне от 0 до 9. |
s Параметр анализируется с помощью сведений о форматировании в NumberFormatInfo объекте, инициализированном для текущего языка и региональных параметров системы. Для получения дополнительной информации см. CurrentInfo.
Эта перегрузка TryParse метода интерпретирует все цифры в s параметре как десятичные цифры. Чтобы проанализировать строковое представление шестнадцатеричного числа, вызовите Int16.TryParse(String, NumberStyles, IFormatProvider, Int16) перегрузку.
См. также раздел
Применяется к
Преобразует представление числа в виде диапазона в указанном стиле и формате, соответствующем языку и региональным параметрам, в эквивалентное ему 16-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование.
Параметры
Диапазон, содержащий символы, которые представляют преобразуемое число.
Возвращаемое значение
Применяется к
TryParse(String, NumberStyles, IFormatProvider, Int16)
Преобразует строковое представление числа в формате, соответствующем языку и региональным параметрам, в эквивалентное ему 16-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование.
Параметры
Объект, который предоставляет сведения о форматировании параметра s в зависимости от языка и региональных параметров.
Возвращаемое значение
Исключения
style не является значением NumberStyles.
-или- style не является сочетанием значений AllowHexSpecifier и HexNumber.
Примеры
В следующем примере вызывается Int16.TryParse(String, NumberStyles, IFormatProvider, Int16) метод с количеством различных строковых значений.
Комментарии
Int16.TryParse(String, NumberStyles, IFormatProvider, Int16)Метод отличается от Int16.Parse(String, NumberStyles, IFormatProvider) метода, возвращая логическое значение, которое указывает, завершилась ли операция синтаксического анализа, а не возвращать проанализированное Int16 значение. Это исключает необходимость использования обработки исключений для проверки FormatException в случае, если событие s является недопустимым и его невозможно успешно проанализировать.
style Параметр определяет элементы стиля (например, пробелы или положительный или отрицательный знак), допустимые в s параметре для успешной операции синтаксического анализа. Он должен представлять собой сочетание битовых флагов из NumberStyles перечисления. В зависимости от значения Style s параметр может включать следующие элементы:
Протокол [$] писать [цифры,] цифры [.fractional_digits] [e [знак] цифры] [ws]
Элементы в квадратных скобках ([и]) являются необязательными. Каждый из элементов описан в таблице ниже.
Все завершающие символы NUL (U + 0000) в s игнорируются операцией синтаксического анализа, независимо от значения style аргумента.
Time Span. Try Parse Метод
Определение
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Преобразовывает указанное строковое представление интервала времени в его эквивалент TimeSpan и возвращает значение, позволяющее определить успешность преобразования.
Перегрузки
Преобразует представление диапазона интервала времени в его эквивалент TimeSpan, используя указанную информацию о форматировании, связанную с языком и региональными параметрами, и возвращает значение, которое показывает успешность преобразования.
Преобразует представление диапазона интервала времени в его эквивалент TimeSpan и возвращает значение, позволяющее определить успешность преобразования.
Преобразовывает строковое представление интервала времени в его эквивалент TimeSpan и возвращает значение, позволяющее определить успешность преобразования.
Преобразовывает заданное строковое представление интервала времени в его эквивалент TimeSpan, используя указанную информацию о форматировании, связанную с языком и региональными параметрами, и возвращает значение, которое показывает успешность преобразования.
Преобразует представление диапазона интервала времени в его эквивалент TimeSpan, используя указанную информацию о форматировании, связанную с языком и региональными параметрами, и возвращает значение, которое показывает успешность преобразования.
Параметры
Диапазон, содержащий символы, которые представляют интервал времени для преобразования.
Объект, предоставляющий сведения о форматировании для определенного языка и региональных параметров.
Возвращаемое значение
Применяется к
Преобразует представление диапазона интервала времени в его эквивалент TimeSpan и возвращает значение, позволяющее определить успешность преобразования.
Параметры
Диапазон, содержащий символы, которые представляют интервал времени для преобразования.
Возвращаемое значение
Применяется к
TryParse(String, TimeSpan)
Преобразовывает строковое представление интервала времени в его эквивалент TimeSpan и возвращает значение, позволяющее определить успешность преобразования.
Параметры
Строка, которая указывает преобразуемый интервал времени.
Возвращаемое значение
Примеры
В следующем примере метод используется TryParse для создания TimeSpan объектов из допустимых TimeSpan строк и для указания на сбой операции синтаксического анализа из-за недопустимой строки временного диапазона.
Комментарии
TryParseМетод похож на TimeSpan.Parse(String) метод, за исключением того, что он не создает исключение, если преобразование завершается неудачей.
s Параметр содержит спецификацию интервала времени в формате:
Элементы в квадратных скобках ([и]) являются необязательными. Требуется один выбор из списка альтернатив, заключенного в фигурные скобки (<и>) и разделенных вертикальными чертами (|). Каждый из элементов описан в таблице ниже.
Parse(String)Метод пытается выполнить синтаксический анализ с s использованием каждого из форматов, зависящих от языка и региональных параметров, для текущего языка и региональных параметров.
Примечания для вызывающих объектов
Применяется к
TryParse(String, IFormatProvider, TimeSpan)
Преобразовывает заданное строковое представление интервала времени в его эквивалент TimeSpan, используя указанную информацию о форматировании, связанную с языком и региональными параметрами, и возвращает значение, которое показывает успешность преобразования.
Параметры
Строка, которая указывает преобразуемый интервал времени.
Объект, предоставляющий сведения о форматировании для определенного языка и региональных параметров.
Возвращаемое значение
Примеры
В следующем примере определяется массив CultureInfo объектов и используется каждый объект в вызовах TryParse(String, IFormatProvider, TimeSpan) метода для анализа элементов в массиве строк. В примере показано, как соглашения определенного языка и региональных параметров влияют на операцию форматирования.
Комментарии
TryParse(String, IFormatProvider, TimeSpan)Метод похож на Parse(String, IFormatProvider) метод, за исключением того, что он не создает исключение, если преобразование завершается неудачей.
input Параметр содержит спецификацию интервала времени в формате:
Элементы в квадратных скобках ([и]) являются необязательными. Требуется один выбор из списка альтернатив, заключенного в фигурные скобки (<и>) и разделенных вертикальными чертами (|). Каждый из элементов описан в таблице ниже.
formatProvider Параметр — это IFormatProvider реализация, которая предоставляет сведения о формате возвращаемой строки, зависящей от языка и региональных параметров. formatProvider Параметр может быть любым из следующих:
CultureInfoОбъект, представляющий язык и региональные параметры, соглашения о форматировании которых должны быть отражены в возвращаемой строке. DateTimeFormatInfoОбъект, возвращаемый CultureInfo.DateTimeFormat свойством, определяет форматирование возвращаемой строки.
DateTimeFormatInfoОбъект, определяющий форматирование возвращаемой строки.
Пользовательский объект, реализующий IFormatProvider интерфейс. Его IFormatProvider.GetFormat метод возвращает DateTimeFormatInfo объект, предоставляющий сведения о форматировании.
Date Time. Try Parse Метод
Определение
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Преобразовывает указанное строковое представление даты и времени в его эквивалент DateTime и возвращает значение, позволяющее определить успешность преобразования.
Перегрузки
Преобразует представление даты и времени в виде диапазона в его эквивалент DateTime, используя указанную информацию о форматировании, связанную с языком и региональными параметрами, и возвращает значение, которое показывает успешность преобразования.
Преобразовывает указанное строковое представление даты и времени в его эквивалент DateTime и возвращает значение, позволяющее определить успешность преобразования.
Преобразует заданное строковое представление даты и времени в его эквивалент DateTime, используя указанную информацию о форматировании, связанную с языком и региональными параметрами, и возвращает значение, которое показывает успешность преобразования.
Преобразовывает указанный диапазон символов даты и времени в его эквивалент DateTime и возвращает значение, позволяющее определить успешность преобразования.
Комментарии
Преобразует представление даты и времени в виде диапазона в его эквивалент DateTime, используя указанную информацию о форматировании, связанную с языком и региональными параметрами, и возвращает значение, которое показывает успешность преобразования.
Параметры
Диапазон, содержащий символы, которые представляют преобразуемые дату и время.
Объект, который предоставляет сведения о форматировании параметра s в зависимости от языка и региональных параметров.
Побитовая комбинация значений перечисления, которая определяет, как интерпретировать проанализированную дату по отношению к текущему часовому поясу или текущей дате. Обычно указывается значение None.
Возвращаемое значение
Применяется к
TryParse(String, DateTime)
Преобразовывает указанное строковое представление даты и времени в его эквивалент DateTime и возвращает значение, позволяющее определить успешность преобразования.
Параметры
Строка, содержащая дату и время, которые нужно преобразовать.
Возвращаемое значение
Примеры
Комментарии
DateTime.TryParse(String, DateTime)Метод аналогичен DateTime.Parse(String) методу, за исключением того, что TryParse(String, DateTime) метод не создает исключение, если преобразование завершается неудачей.
Строка s анализируется с помощью сведений о форматировании в текущем DateTimeFormatInfo объекте, который неявно предоставляется культурой текущего потока.
Этот метод пытается проигнорировать нераспознанные данные, если это возможно, и заполнить отсутствующие данные месяца, дня и года на текущую дату. Если s содержит только дату и время, этот метод предполагает, что время составляет 12:00 полночь. Если s содержит компонент даты с двузначным годом, он преобразуется в год текущего календаря языка и региональных параметров в соответствии со значением Calendar.TwoDigitYearMax Свойства. Любой начальный, внутренний или конечный символ пробела в s не учитывается. Дата и время могут быть заключены в скобки с парой начальных и конечных символов РЕШЕТКи (‘ # ‘, U + 0023), а также могут заканчиваться одним или несколькими символами NULL (U + 0000).
Поскольку DateTime.TryParse(String, DateTime) метод пытается проанализировать строковое представление даты и времени с помощью правил форматирования текущего языка и региональных параметров, попытка выполнить синтаксический анализ определенной строки в разных культурах может завершиться неудачей или возвращать разные результаты. Если конкретный формат даты и времени будет анализироваться по разным языкам, используйте DateTime.TryParse(String, IFormatProvider, DateTimeStyles, DateTime) метод или одну из перегрузок TryParseExact метода и укажите описатель формата.
Если s не содержит сведений о часовом поясе, result содержит DateTime значение, Kind свойство которого является DateTimeKind.Unspecified моментом возврата метода. Если строка для синтаксического анализа содержит сведения о часовом поясе, result содержит DateTime значение, Kind свойство которого является DateTimeKind.Local моментом возврата метода.
Примечания для тех, кто вызывает этот метод
На форматирование влияют свойства текущего DateTimeFormatInfo объекта, которые по умолчанию наследуются из элемента язык и региональные стандарты панели управления. TryParseМетод может неожиданно завершиться с ошибкой и возвращать False DateSeparator TimeSeparator значение, если для текущего свойства и задано одно или несколько значений.
См. также раздел
Применяется к
TryParse(String, IFormatProvider, DateTimeStyles, DateTime)
Преобразует заданное строковое представление даты и времени в его эквивалент DateTime, используя указанную информацию о форматировании, связанную с языком и региональными параметрами, и возвращает значение, которое показывает успешность преобразования.
Параметры
Строка, содержащая дату и время, которые нужно преобразовать.
Объект, который предоставляет сведения о форматировании параметра s в зависимости от языка и региональных параметров.
Побитовая комбинация значений перечисления, которая определяет, как интерпретировать проанализированную дату по отношению к текущему часовому поясу или текущей дате. Обычно указывается значение None.
Возвращаемое значение
Исключения
styles не является допустимым значением DateTimeStyles.
-или- styles содержит недопустимое сочетание значений DateTimeStyles (например, и AssumeLocal, и AssumeUniversal ).
provider является нейтральным языком и региональными параметрами и не может использоваться в операции анализа.
Примеры
Комментарии
DateTime.TryParse(String, IFormatProvider, DateTimeStyles, DateTime)Метод анализирует строку, которая может содержать дату, время и сведения о часовом поясе. Он аналогичен DateTime.Parse(String, IFormatProvider, DateTimeStyles) методу, за исключением того, что DateTime.TryParse(String, DateTime) метод не создает исключение, если преобразование завершается неудачей.
Конкретные допустимые форматы для элементов даты и времени, а также имена и символы, используемые в датах и времени, определяются provider параметром, который может принимать любое из следующих значений:
styles Параметр определяет точную интерпретацию проанализированной строки и способ ее обработки операцией синтаксического анализа. Это может быть один или несколько членов DateTimeStyles перечисления, как описано в следующей таблице.
Если s не содержит сведений о часовом поясе, DateTime.TryParse(String, IFormatProvider, DateTimeStyles, DateTime) метод возвращает DateTime значение, Kind свойство которого равно, DateTimeKind.Unspecified Если флаг не styles указывает иное. Если s содержит сведения о часовом поясе или часовом поясе, DateTime.TryParse(String, IFormatProvider, DateTimeStyles, DateTime) метод выполняет все необходимое преобразование времени и возвращает одно из следующих:
Это поведение можно переопределить с помощью DateTimeStyles.RoundtripKind флага.
Анализ пользовательских культур
При синтаксическом анализе строки даты и времени, созданной для пользовательского языка и региональных параметров, используйте TryParseExact метод вместо TryParse метода, чтобы повысить вероятность того, что операция анализа будет выполнена. Строка даты и времени пользовательского языка и региональных параметров может быть сложной и сложной для анализа. TryParseМетод пытается выполнить синтаксический анализ строки с несколькими неявными шаблонами синтаксического анализа, все из которых может завершиться ошибкой. В отличие от этого, TryParseExact метод требует явного назначения одного или более точных шаблонов анализа, которые, вероятнее всего, будут успешны.
Дополнительные сведения о пользовательских культурах см. в разделе System.Globalization.CultureAndRegionInfoBuilder класс.
Примечания для тех, кто вызывает этот метод
На форматирование влияют свойства текущего DateTimeFormatInfo объекта, предоставляемые provider параметром. TryParseМетод может неожиданно завершиться с ошибкой и возвращать False DateSeparator TimeSeparator значение, если для текущего свойства и задано одно или несколько значений.