Partager via

SendMailErrorEventArgs Classe

Définition

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

Fournit des données pour l’événement SendMailError de contrôles tels que le ChangePassword contrôle, le CreateUserWizard contrôle et le PasswordRecovery contrôle.

public ref class SendMailErrorEventArgs : EventArgs
public class SendMailErrorEventArgs : EventArgs
type SendMailErrorEventArgs = class
    inherit EventArgs
Public Class SendMailErrorEventArgs
Inherits EventArgs
Héritage
Object
EventArgs
SendMailErrorEventArgs

Remarques

L’objet SendMailErrorEventArgs contient un message d’erreur déclenché par le fournisseur de messagerie SMTP lorsqu’un message électronique ne peut pas être envoyé par le ChangePassword contrôle ou le CreateUserWizard contrôle. Dans ce cas, l’objet SendMailErrorEventArgs est envoyé au SendMailErrorEventHandler.

Créez un SendMailErrorEventHandler délégué pour gérer l’événement. La gestion de l’événement permet à votre application web de continuer à s’exécuter même si une exception s’est produite. Cela est utile lorsqu’il n’est pas essentiel d’envoyer un e-mail. Par exemple, si l’exception se produit lorsqu’un utilisateur travaille via un Assistant à plusieurs étapes, il peut être avantageux de consigner l’erreur, d’afficher un message informatif à l’utilisateur et d’autoriser l’utilisateur à terminer l’Assistant.

Examinez la Exception propriété pour déterminer la cause réelle de l’exception. La raison la plus courante de l’exception est une erreur de configuration dans l’élément< SMTP> (Paramètres réseau) du fichier de configuration de l’ordinateur. Bien qu’une erreur similaire à celle-ci soit généralement détectée pendant le développement et le débogage d’une application, les serveurs de messagerie peuvent échouer de manière inattendue dans un environnement de production, et vous devez déterminer si l’ensemble de l’application échoue dans cette situation. Si ce n’est pas le cas, la gestion de l’événement permet à votre application de continuer.

Vous devez définir la Handled propriété pour true signaler que l’exception a été gérée ; sinon, l’exception est réinscrite et inclut la pile d’appels d’origine et le message d’erreur.

Si vous ne créez pas de gestionnaire d’événements pour l’événement, ou si vous créez un gestionnaire d’événements, mais laissez la Handled propriété définie falsesur , votre application web cesse de s’exécuter si une erreur se produit lors de l’envoi SendMailError d’un message électronique, et ASP.NET affiche un message d’erreur.

La OnSendMailError méthode permet également aux classes dérivées de gérer l’événement, au lieu d’être effectuées par le SendMailErrorEventHandler. Il s’agit de la technique recommandée pour gérer l’événement dans une classe dérivée ou ChangePasswordCreateUserWizard.

Pour plus d’informations sur la gestion des événements, consultez Gestion des événements de serveur dans ASP.NET pages Web Forms.

Notes pour les héritiers

En cas de OnSendMailError(SendMailErrorEventArgs) substitution dans une classe dérivée, veillez à appeler la OnSendMailError(SendMailErrorEventArgs) méthode de la classe de base pour permettre aux délégués inscrits de recevoir l’événement.

Constructeurs

Nom Description
SendMailErrorEventArgs(Exception)

Initialise une nouvelle instance de la classe SendMailErrorEventArgs.

Propriétés

Nom Description
Exception

Retourne l’exception levée par un service de messagerie SMTP lorsqu’un message électronique ne peut pas être envoyé.
Handled

Indique si l’exception SMTP contenue dans la Exception propriété a été gérée.

Méthodes

Nom Description
Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l’objet actuel.

(Hérité de Object)

S’applique à

Voir aussi