The PasswordRecovery.OnSendMailError(SendMailErrorEventArgs) method is called when the SMTP Mail service throws an exception. The default implementation raises the PasswordRecovery.SendMailError error and, if the exception is not handled, rethrows the exception while maintaining the call stack.

Examine the SendMailErrorEventArgs.Exception property of the System.Web.UI.WebControls.SendMailErrorEventArgs object passed as the e parameter to determine the actual cause of the exception. During development, the most common reason that the PasswordRecovery.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 SendMailErrorEventArgs.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 Pages.

The PasswordRecovery.OnSendMailError(SendMailErrorEventArgs) 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.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)
Assembly Versions: 2.0.0.0
Since: .NET 2.0