SendMailErrorEventArgs.Handled Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Označuje, zda byla zpracována výjimka SMTP obsažená ve Exception vlastnosti.
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 BooleanHodnota vlastnosti
Pokud trueje výjimka spotřebována a zpracována delegátem SendMailErrorEventHandler . Pokud falsese výjimka znovu zobrazí, včetně původního zásobníku volání a chybové zprávy.
Výchozí hodnota je false.
Poznámky
Vlastnost Handled označuje, zda Exception byla zpracována. Výjimka je vyvolána poskytovatelem pošty SMTP, pokud nelze odeslat e-mailovou CreateUserWizardzprávu ovládacím ChangePassword prvku nebo . Nejběžnějším důvodem výjimky je chyba konfigurace v elementu< SMTP> (Nastavení sítě) konfiguračního souboru počítače. I když se při vývoji a ladění aplikace obvykle zjistí chyba podobná této chybě, poštovní servery můžou neočekávaně selhat v produkčním prostředí a musíte určit, jestli má celá aplikace v takové situaci selhat. Pokud ne, zpracování události umožní vaší aplikaci pokračovat.
Pokud pro událost nevytvoříte obslužnou rutinu SendMailError události nebo pokud vytvoříte obslužnou rutinu události, ale ponecháte Handled ji nastavenou na false, webová aplikace se zastaví, pokud při odesílání e-mailové zprávy dojde k chybě, a ASP.NET zobrazí chybovou zprávu. Zpracování události umožňuje webové aplikaci pokračovat ve spuštění, i když došlo k výjimce. To je užitečné, když není důležité odeslat e-mailovou zprávu. Pokud například dojde k výjimce, když uživatel pracuje v průvodci více kroky, může být výhodné chybu protokolovat, zobrazit uživateli informativní zprávu a umožnit uživateli dokončit průvodce.
