SendMailErrorEventArgs.Handled Propriété
Définition
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.
Indique si l’exception SMTP contenue dans la Exception propriété a été gérée.
public:
property bool Handled { bool get(); void set(bool value); };public bool Handled { get; set; }member this.Handled : bool with get, setPublic Property Handled As BooleanValeur de propriété
Si true, l’exception est consommée et gérée par le SendMailErrorEventHandler délégué. Si false, l’exception est rethrown, y compris la pile d’appels d’origine et le message d’erreur.
La valeur par défaut est false.
Remarques
La Handled propriété indique si la Exception propriété a été gérée. L’exception est levée par le fournisseur de messagerie SMTP lorsqu’un message électronique ne peut pas être envoyé par le ChangePassword contrôle ou le CreateUserWizard. 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.
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 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.
