Объектная модель > Основные механизмы > AppliedCodeException – исключение для генерации из прикладного кода

При возникновении ошибки система сообщает о ней при помощи исключения, в котором содержится информация об ошибке. Например, если по заданному пути отсутствует файл или дальнейшие вычисления в соответствии с базовым алгоритмом невозможны или нецелесообразны.

Разработчик сам может генерировать исключения в случае ошибочных ситуаций. Например, если не задано значение обязательного свойства или нет прав доступа к данным.

Все классы исключений, которые необходимо генерировать в коде, наследуются от базового класса System.Exception. Он содержит основную информацию об исключении: стек вызова, сообщение, внутренние исключения и т.д. При этом в среде разработки запрещается генерировать и перехватывать родные исключения .NET. Например, исключение ArgumentOutOfRangeException. Подробнее см. раздел «Генерация и перехватывание исключений».

Для генерации и перехватывания прикладных исключений используется класс AppliedCodeException.

Методы

Имя	Описание
Create() + 8 перегрузок	Создать прикладное исключение

Свойства

Имя	Тип	Описание
Description	LocalizedString	Локализованное сообщение с подробным описанием ошибки
IsInternal	Bool	Признак того, что исключение является внутренним и не отображается для пользователя
LocalizedMessage	LocalizedString	Локализованное сообщение исключения

Создать прикладное исключение – Create

Метод используется для создания прикладного исключения.

Перегрузки

Create(LocalizedString message)	Создать исключение, добавить локализованное сообщение исключения
Create(string message)	Создать исключение, добавить сообщение исключения
Create(LocalizedString message, LocalizedString description)	Создать исключение, добавить локализованное сообщение исключения и подробное описание ошибки
Create(string message, string description)	Создать исключение, добавить сообщение исключения и описание ошибки
Create(LocalizedString message, Exception innerException)	Создать исключение, которое ссылается на внутреннее исключение, добавить локализованное сообщение исключения
Create(string message, Exception innerException)	Создать исключение, которое ссылается на внутреннее исключение, добавить сообщение исключения
Create(LocalizedString message, LocalizedString description, Exception innerException)	Создать исключение, которое ссылается на внутреннее исключение, добавить локализованное сообщение исключения и подробное описание ошибки
Create(string message, string description, Exception innerException)	Создать исключение, которое ссылается на внутреннее исключение, добавить сообщение исключения и описание ошибки

Синтаксис

public static AppliedCodeException Create(LocalizedString message, LocalizedString description, Exception innerException);

public static AppliedCodeException Create (string message, string description, Exception innerException);

Параметры

message – сообщение. Может принимать значения типа string или LocalizedString;

description – описание сообщения. Может принимать значения типа string или LocalizedString;

innerException – внутреннее исключение.

Возвращаемое значение

Прикладное исключение.

Пример. Создание исключения при проверке прав на запуск инициализации модуля

// Проверить разрешение на запуск инициализации.

[Remote, Public]

public static void CheckRightsToInitialize()

{

  if (!Users.Current.IncludedIn(Roles.Administrators))

     throw AppliedCodeException.Create("Only administrator can run initialize.");

}

СМ. ТАКЖЕ