PasswordRecovery.OnSendMailError(SendMailErrorEventArgs) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
當電子郵件訊息無法傳送給使用者時,引發 SendMailError 事件。
protected:
virtual void OnSendMailError(System::Web::UI::WebControls::SendMailErrorEventArgs ^ e);
protected virtual void OnSendMailError (System.Web.UI.WebControls.SendMailErrorEventArgs e);
abstract member OnSendMailError : System.Web.UI.WebControls.SendMailErrorEventArgs -> unit
override this.OnSendMailError : System.Web.UI.WebControls.SendMailErrorEventArgs -> unit
Protected Overridable Sub OnSendMailError (e As SendMailErrorEventArgs)
參數
SendMailErrorEventArgs,其中包含事件資料。
備註
當 SMTP Mail 服務擲回例外狀況時,會 OnSendMailError 呼叫 方法。 默認實作會 SendMailError 引發錯誤,如果未處理例外狀況,則會在維護呼叫堆棧時重新擲回例外狀況。
Exception檢查傳遞為 e
參數的物件SendMailErrorEventArgs屬性,以判斷例外狀況的實際原因。 在開發期間,引發<smtpMail>
事件最常見的原因是 SendMailError Web.config 檔案的 區段不正確。 部署之後,可能會因為各種原因而發生此事件,大部分都必須處理電子郵件位址中的錯誤。
您必須將傳遞為 參數的物件屬性設定 Handled 為 e
, true
以發出已處理例外狀況的訊號,否則會再次擲回例外狀況。
引發事件會透過委派叫用此事件處理常式。 如需詳細資訊,請參閱 ASP.NET 網頁中的伺服器事件處理。
OnSendMailError 方法也允許衍生類別處理事件,而不用附加委派。 這是在衍生類別中處理事件的慣用技巧。
給繼承者的注意事項
在衍生類別中覆 OnSendMailError(SendMailErrorEventArgs) 寫 方法時,請務必呼叫 OnSendMailError(SendMailErrorEventArgs) 基類的方法,讓已註冊的委派接收事件。