SendMailErrorEventArgs Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет данные для SendMailError события таких элементов управления, как ChangePassword элемент управления, CreateUserWizard элемент управления и PasswordRecovery элемент управления.
public ref class SendMailErrorEventArgs : EventArgspublic class SendMailErrorEventArgs : EventArgstype SendMailErrorEventArgs = class
inherit EventArgsPublic Class SendMailErrorEventArgs
Inherits EventArgs- Наследование
Комментарии
Объект SendMailErrorEventArgs содержит сообщение об ошибке, которое вызывается поставщиком почты SMTP, когда сообщение электронной почты не может быть отправлено ChangePassword элементом управления или элементом CreateUserWizard управления. В таком случае SendMailErrorEventArgs объект отправляется SendMailErrorEventHandlerв .
SendMailErrorEventHandler Создайте делегат для обработки события. Обработка события позволяет веб-приложению продолжать работать, даже если произошло исключение. Это полезно, если это не очень важно для отправки сообщения электронной почты. Например, если исключение возникает, когда пользователь работает с мастером с несколькими шагами, это может быть полезно для регистрации ошибки, отображения информативного сообщения пользователю и разрешения пользователю завершить работу мастера.
Exception Проверьте свойство, чтобы определить фактическую причину исключения. Наиболее распространенной причиной исключения является ошибка конфигурации в <smtp-элементе> (параметры сети) файла конфигурации компьютера. Хотя такая ошибка обычно обнаруживается во время разработки и отладки приложения, почтовые серверы могут неожиданно завершиться сбоем в рабочей среде, и необходимо определить, требуется ли в этой ситуации завершиться сбоем всего приложения. В противном случае обработка события позволяет приложению продолжить работу.
Необходимо задать Handled свойство, чтобы true сообщить о том, что исключение обработано; в противном случае исключение выполняется повторно, и будет содержать исходное стек вызовов и сообщение об ошибке.
Если вы не создаете обработчик событий для SendMailError события или создаете обработчик событий, но не оставляете Handled значение свойства, falseвеб-приложение перестанет работать, если при отправке сообщения электронной почты возникает ошибка, и ASP.NET отобразит сообщение об ошибке.
Метод OnSendMailError также позволяет производным классам обрабатывать событие, а не делать SendMailErrorEventHandlerэто. Это предпочтительный способ обработки события в классе, который является производным от ChangePassword или CreateUserWizard.
Дополнительные сведения об обработке событий см. в разделе "Обработка событий сервера" на страницах веб-форм ASP.NET.
Примечания для тех, кто наследует этот метод
При переопределении OnSendMailError(SendMailErrorEventArgs) в производном классе обязательно вызовите OnSendMailError(SendMailErrorEventArgs) метод базового класса, чтобы разрешить зарегистрированным делегатам получать событие.
Конструкторы
| Имя | Описание |
|---|---|
| SendMailErrorEventArgs(Exception) |
Инициализирует новый экземпляр класса SendMailErrorEventArgs. |
Свойства
| Имя | Описание |
|---|---|
| Exception |
Возвращает исключение, возникающее службой электронной почты SMTP, если сообщение электронной почты не может быть отправлено. |
| Handled |
Указывает, было ли обработано исключение SMTP, содержащееся в свойстве Exception . |
Методы
| Имя | Описание |
|---|---|
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
