PasswordRecovery.OnSendMailError(SendMailErrorEventArgs) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Raises the SendMailError event when an email message cannot be sent to the user.
protected:
virtual void OnSendMailError(System::Web::UI::WebControls::SendMailErrorEventArgs ^ e);
protected virtual void OnSendMailError (System.Web.UI.WebControls.SendMailErrorEventArgs e);
abstract member OnSendMailError : System.Web.UI.WebControls.SendMailErrorEventArgs -> unit
override this.OnSendMailError : System.Web.UI.WebControls.SendMailErrorEventArgs -> unit
Protected Overridable Sub OnSendMailError (e As SendMailErrorEventArgs)
Parameters
A SendMailErrorEventArgs that contains the event data.
Remarks
The OnSendMailError method is called when the SMTP Mail service throws an exception. The default implementation raises the SendMailError error and, if the exception is not handled, rethrows the exception while maintaining the call stack.
Examine the Exception property of the SendMailErrorEventArgs object passed as the e
parameter to determine the actual cause of the exception. During development, the most common reason that the SendMailError event is raised is that the <smtpMail>
section of the Web.config file is incorrect. After deployment, this event can occur for a variety of reasons, most having to do with errors in an email address.
You must set the Handled property of the object passed as the e
parameter to true
to signal that the exception has been handled; otherwise, the exception is thrown again.
Raising an event invokes the event handler through a delegate. For more information, see Server Event Handling in ASP.NET Web Forms Pages.
The OnSendMailError method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.
Notes to Inheritors
When overriding the OnSendMailError(SendMailErrorEventArgs) method in a derived class, be sure to call the OnSendMailError(SendMailErrorEventArgs) method for the base class so that registered delegates receive the event.
Applies to
See also
- SendMailErrorEventArgs
- SendMailError
- OnBubbleEvent(Object, EventArgs)
- Server Event Handling in ASP.NET Web Pages
- ASP.NET Login Controls Overview
- Customizing Appearance and Behavior of the ASP.NET Login Controls
- How to: Display Different Information to Anonymous and Logged In Users
- Web Site Administration Tool Security Tab
- Securing Login Controls
- Basic Security Practices for Web Applications
- Securing Membership