PasswordRecovery.OnSendMailError(SendMailErrorEventArgs) Método

Definición

Genera el evento SendMailError cuando un mensaje de correo electrónico no se puede enviar al usuario.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)

Parámetros

e
SendMailErrorEventArgs

Objeto SendMailErrorEventArgs que contiene los datos del evento.A SendMailErrorEventArgs that contains the event data.

Comentarios

OnSendMailErrorSe llama al método cuando el servicio de correo SMTP produce una excepción.The OnSendMailError method is called when the SMTP Mail service throws an exception. La implementación predeterminada genera el SendMailError error y, si la excepción no se controla, vuelve a producir la excepción mientras se mantiene la pila de llamadas.The default implementation raises the SendMailError error and, if the exception is not handled, rethrows the exception while maintaining the call stack.

Examine la Exception propiedad del SendMailErrorEventArgs objeto que se pasa como e parámetro para determinar la causa real de la excepción.Examine the Exception property of the SendMailErrorEventArgs object passed as the e parameter to determine the actual cause of the exception. Durante el desarrollo, la razón más común por la que SendMailError se genera el evento es que la <smtpMail> sección del archivo Web.config es incorrecta.During development, the most common reason that the SendMailError event is raised is that the <smtpMail> section of the Web.config file is incorrect. Después de la implementación, este evento puede producirse por una serie de motivos, la mayoría de los cuales tienen errores en una dirección de correo electrónico.After deployment, this event can occur for a variety of reasons, most having to do with errors in an email address.

Debe establecer la Handled propiedad del objeto que se pasa como e parámetro en true para indicar que se ha controlado la excepción; de lo contrario, se vuelve a producir la excepción.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.

Cuando se genera un evento, se invoca el controlador de eventos a través de un delegado.Raising an event invokes the event handler through a delegate. Para obtener más información, vea control de eventos de servidor en páginas de formularios Web Forms de ASP.net.For more information, see Server Event Handling in ASP.NET Web Forms Pages.

El método OnSendMailError también permite que las clases derivadas controlen el evento sin adjuntar ningún delegado.The OnSendMailError method also allows derived classes to handle the event without attaching a delegate. Ésta es la técnica preferida para controlar el evento en una clase derivada.This is the preferred technique for handling the event in a derived class.

Notas a los desarrolladores de herederos

Al reemplazar el OnSendMailError(SendMailErrorEventArgs) método en una clase derivada, asegúrese de llamar al OnSendMailError(SendMailErrorEventArgs) método de la clase base para que los delegados registrados reciban el evento.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.

Se aplica a

Consulte también