PasswordRecovery.OnSendMailError(SendMailErrorEventArgs) Méthode

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Déclenche l’événement SendMailError lorsqu’un e-mail ne peut pas être envoyé à l’utilisateur.

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)

Paramètres

e
SendMailErrorEventArgs

SendMailErrorEventArgs qui contient les données d’événement.

Remarques

La OnSendMailError méthode est appelée lorsque le service de messagerie SMTP lève une exception. L’implémentation par défaut déclenche l’erreur SendMailError et, si l’exception n’est pas gérée, la relance tout en conservant la pile des appels.

Examinez la Exception propriété de l’objet SendMailErrorEventArgs passé en tant que e paramètre pour déterminer la cause réelle de l’exception. Pendant le développement, la raison la plus courante pour laquelle l’événement SendMailError est déclenché est que la <smtpMail> section du fichier Web.config est incorrecte. Après le déploiement, cet événement peut se produire pour diverses raisons, la plupart en raison d’erreurs dans une adresse e-mail.

Vous devez définir la Handled propriété de l’objet passé en tant que e paramètre sur true pour signaler que l’exception a été gérée ; sinon, l’exception est levée à nouveau.

Le déclenchement d'un événement appelle le gestionnaire des événements par l'intermédiaire d'un délégué. Pour plus d’informations, consultez Gestion des événements serveur dans ASP.NET Web Forms Pages.

La méthode OnSendMailError permet également aux classes dérivées de gérer l'événement sans y attacher de délégué. Il s'agit de la méthode recommandée pour gérer l'événement dans une classe dérivée.

Notes pour les héritiers

Lorsque vous remplacez la OnSendMailError(SendMailErrorEventArgs) méthode dans une classe dérivée, veillez à appeler la OnSendMailError(SendMailErrorEventArgs) méthode pour la classe de base afin que les délégués inscrits reçoivent l’événement.

S’applique à

Voir aussi