Оператор генерирует новое исключение
Вариант синтаксиса базовый
Оператор ВызватьИсключение имеет следующий синтаксис:
ВызватьИсключение [Выражение];
А также альтернативный англоязычный синтаксис:
Raise [Expression];
Параметры
Оператор ВызватьИсключение() не имеет формальных параметров.
Описание
Оператор ВызватьИсключение генерирует новое исключение. Если вызову оператора предшествовала другая исключительная ситуация, перехваченная в блоке Попытка..Исключение, параметр Выражение можно опустить. В этом случае будет использована информация об ошибке, перехваченная ранее. Однако, можно указать свое представление ошибки в параметре Выражение.
Если вызов происходит в пределах блока Попытка .. Исключение, обработка исключительной ситуации происходит в этом же блоке. В противном случае выполняется поиск вышестоящей попытки. Если обработка ошибок не была предусмотрена разработчиком, пользователю будет выдано сообщение об ошибке, подобно этому:
Вариант синтаксиса 8.3.21+
Начиная с версии платфомры 1С:Предприятие 8.3.21 оператор ВызватьИсключение обзавелся дополнительными параметрами и получил следующий вариант синтаксиса:
ВызватьИсключение [(Выражение, [Категория], [Код], [ДополнительнаяИнформация], [Причина])];
А также альтернативный англоязычный синтаксис:
Raise [(Expression, [Category], [Code], [AddInfo], [ErrorInfo])];
Параметры
Описание параметров метода ВызватьИсключение():
| Имя параметра* | Тип | Описание |
|---|---|---|
| Выражение | Строка | Строковое представление ошибки. Если другие параметры не указаны, работает аналогично базовому варианту синтаксиса:ВызватьИсключение <Выражение>. |
| Категория | КатегорияОшибки | Устанавливает категорию ошибки. Категория будет отображена пользователю. Значение по умолчанию: Неопределено |
| Код | Строка | Устанавливает код ошибки, которое может использоваться в обработчиках ошибок для классификации исключений. Подробнее см. ИнформацияОбОшибке.Код. Значение по умолчанию: Пустая строка |
| ДополнительнаяИнформация | Строка | Дополнительная информация о формируемой ошибке. Подробнее см. ИнформацияОбОшибке.ДополнительнаяИнформация. Значение по умолчанию: Пустая строка |
| Причина | ИнформацияОбОшибке | Информация о вышестоящей ошибке, ставшей причиной текущего исключения (например, ошибка во вложенной транзакции) |
| *Жирным шрифтом выделены обязательные параметры | ||
Описание
Оператор ВызватьИсключение генерирует новое исключение, при этом существует возможность детально описать информацию об исключительной ситуации.
Доступность
| Версия | Поддержка |
|---|---|
| 8.1 | Сервер, Клиент, Внешнее соединение |
| 8.2 | Сервер, Толстый клиент, Тонкий клиент, Веб-клиент, Внешнее соединение |
| 8.3 | Сервер, Толстый клиент, Тонкий клиент, Веб-клиент, Внешнее соединение, Мобильный автономный сервер, Мобильный клиент, Мобильное приложение |
Пример использования
Пример кода с использованием метода ВызватьИсключение():
пример скоро будет...