SendMailErrorEventArgs.Handled Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Указывает, было ли обработано исключение SMTP, содержащееся в свойстве Exception .
public:
property bool Handled { bool get(); void set(bool value); };public bool Handled { get; set; }member this.Handled : bool with get, setPublic Property Handled As BooleanЗначение свойства
Если trueисключение используется и обрабатывается делегатом SendMailErrorEventHandler . Если falseисключение выполняется повторно, включая исходный стек вызовов и сообщение об ошибке.
Значение по умолчанию — false.
Комментарии
Свойство Handled указывает, был ли Exception обработан объект. Исключение вызывается поставщиком почты SMTP, если сообщение электронной почты не может быть отправлено ChangePassword элементом управления или элементом CreateUserWizardуправления. Наиболее распространенной причиной исключения является ошибка конфигурации в <smtp-элементе> (параметры сети) файла конфигурации компьютера. Хотя такая ошибка обычно обнаруживается во время разработки и отладки приложения, почтовые серверы могут неожиданно завершиться сбоем в рабочей среде, и необходимо определить, требуется ли в этой ситуации завершиться сбоем всего приложения. В противном случае обработка события позволяет приложению продолжить работу.
Если вы не создаете обработчик событий для SendMailError события или создаете обработчик событий, но не оставляете Handled значение свойства, falseвеб-приложение перестанет работать, если при отправке сообщения электронной почты возникает ошибка, и ASP.NET отобразит сообщение об ошибке. Обработка события позволяет веб-приложению продолжать работать, даже если произошло исключение. Это полезно, если это не очень важно для отправки сообщения электронной почты. Например, если исключение возникает, когда пользователь работает с мастером с несколькими шагами, это может быть полезно для регистрации ошибки, отображения информативного сообщения пользователю и разрешения пользователю завершить работу мастера.
