Sdílet prostřednictvím

SendMailErrorEventArgs Třída

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Poskytuje data pro SendMailError událost ovládacích prvků, jako ChangePassword je ovládací prvek, CreateUserWizard ovládací prvek a PasswordRecovery ovládací prvek.

public ref class SendMailErrorEventArgs : EventArgs
public class SendMailErrorEventArgs : EventArgs
type SendMailErrorEventArgs = class
    inherit EventArgs
Public Class SendMailErrorEventArgs
Inherits EventArgs
Dědičnost
Object
EventArgs
SendMailErrorEventArgs

Poznámky

Objekt SendMailErrorEventArgs obsahuje chybovou zprávu, která je vyvolána poskytovatelem pošty SMTP, pokud nelze odeslat e-mailovou zprávu ovládacím ChangePassword prvku nebo ovládací prvek CreateUserWizard . V takovém případě SendMailErrorEventArgs se objekt odešle do objektu SendMailErrorEventHandler.

Vytvořte delegáta SendMailErrorEventHandler pro zpracování události. 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.

Exception Prozkoumejte vlastnost a určete skutečnou příčinu výjimky. 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.

Vlastnost je nutné nastavit Handled tak, aby true signalizovala, že výjimka byla zpracována. V opačném případě je výjimka znovu vyvolána a bude obsahovat původní zásobník volání a chybovou zprávu.

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.

Metoda OnSendMailError také umožňuje odvozené třídy zpracovávat událost místo toho, aby to bylo provedeno pomocí SendMailErrorEventHandler. Toto je upřednostňovaná technika pro zpracování události ve třídě, která je odvozena z ChangePassword nebo CreateUserWizard.

Další informace o zpracování událostí naleznete v tématu Zpracování událostí serveru na ASP.NET webových formulářů stránky.

Poznámky pro dědice

Při přepsání OnSendMailError(SendMailErrorEventArgs) v odvozené třídě nezapomeňte volat OnSendMailError(SendMailErrorEventArgs) metodu základní třídy, která umožňuje registrovaným delegátům přijímat událost.

Konstruktory

Name Description
SendMailErrorEventArgs(Exception)

Inicializuje novou instanci SendMailErrorEventArgs třídy.

Vlastnosti

Name Description
Exception

Vrátí výjimku vyvolanou poštovní službou SMTP, když nelze odeslat e-mailovou zprávu.
Handled

Označuje, zda byla zpracována výjimka SMTP obsažená ve Exception vlastnosti.

Metody

Name Description
Equals(Object)

Určuje, zda je zadaný objekt roven aktuálnímu objektu.

(Zděděno od Object)
GetHashCode()

Slouží jako výchozí funkce hash.

(Zděděno od Object)
GetType()

Získá Type aktuální instance.

(Zděděno od Object)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Object.

(Zděděno od Object)
ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)

Platí pro

Viz také