SendMailErrorEventArgs.Handled Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt an, ob die SMTP-Ausnahme, die in der Exception Eigenschaft enthalten ist, behandelt wurde.
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 BooleanEigenschaftswert
Wenn truedie Ausnahme von der SendMailErrorEventHandler Stellvertretung verbraucht und verarbeitet wird. Wenn falsedie Ausnahme erneut ausgelöst wird, einschließlich des ursprünglichen Aufrufstapels und der Fehlermeldung.
Der Standardwert lautet false.
Hinweise
Die Handled Eigenschaft gibt an, ob die Exception Behandlung erfolgt ist. Die Ausnahme wird vom SMTP-E-Mail-Anbieter ausgelöst, wenn eine E-Mail-Nachricht nicht vom ChangePassword Steuerelement oder vom CreateUserWizardSteuerelement gesendet werden kann. Der häufigste Grund für die Ausnahme ist ein Konfigurationsfehler in der <SMTP-Elementdatei> (Netzwerkeinstellungen) der Computerkonfigurationsdatei. Obwohl während der Entwicklung und beim Debuggen einer Anwendung ein Fehler wie dieser erkannt wird, können E-Mail-Server unerwartet in einer Produktionsumgebung fehlschlagen, und Sie müssen ermitteln, ob die gesamte Anwendung in dieser Situation fehlschlagen soll. Wenn dies nicht der Fall ist, kann die Anwendung mit dem Ereignis fortfahren.
Wenn Sie keinen Ereignishandler für das SendMailError Ereignis erstellen oder einen Ereignishandler erstellen, aber die Eigenschaft auf "Set" festlegenfalse, wird die Handled Webanwendung beendet, wenn beim Senden einer E-Mail-Nachricht ein Fehler auftritt, und ASP.NET eine Fehlermeldung anzeigt. Durch die Behandlung des Ereignisses kann Die Webanwendung weiterhin ausgeführt werden, obwohl eine Ausnahme aufgetreten ist. Dies ist nützlich, wenn es nicht wichtig ist, eine E-Mail-Nachricht zu senden. Wenn beispielsweise die Ausnahme auftritt, wenn ein Benutzer einen Mehrschritt-Assistenten durchläuft, kann es vorteilhaft sein, den Fehler zu protokollieren, dem Benutzer eine informative Meldung anzuzeigen und dem Benutzer das Abschließen des Assistenten zu ermöglichen.
