PasswordRecovery.OnSendMailError(SendMailErrorEventArgs) Méthode

Référence

Définition

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

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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, relance l’exception 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 de serveur dans ASP.NET pages Web Forms.

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 méthode pour la OnSendMailError(SendMailErrorEventArgs) classe de base afin que les délégués inscrits reçoivent l’événement.

S’applique à

Partager via