PasswordRecovery.OnSendMailError メソッド

.NET Framework クラス ライブラリ リファレンス

PasswordRecovery.OnSendMailError メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

電子メール メッセージをユーザーに送信できない場合に、SendMailError イベントを発生させます。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Protected Overridable Sub
 OnSendMailError ( _
    e As SendMailErrorEventArgs _
)

Visual Basic (使用法)

Dim e As SendMailErrorEventArgs

Me.OnSendMailError(e)

C#

protected virtual void OnSendMailError (
    SendMailErrorEventArgs e
)

C++

protected:
virtual void OnSendMailError (
    SendMailErrorEventArgs^ e
)

J#

protected void OnSendMailError (
    SendMailErrorEventArgs e
)

JScript

protected function OnSendMailError (
    e : SendMailErrorEventArgs
)

パラメータ

e

イベント データを格納している SendMailErrorEventArgs。

解説

OnSendMailError メソッドは、SMTP メール サービスが例外をスローした場合に呼び出されます。既定の実装は、SendMailError エラーを発生させ、例外が処理されない場合には、呼び出し履歴を保持している間に例外を再度スローします。

e パラメータとして渡された SendMailErrorEventArgs オブジェクトの Exception プロパティを調べて、例外の実際の原因を判断します。開発中に SendMailError イベントが発生する最も一般的な原因は、Web.config ファイルの <smtpMail> セクションに誤りがあることです。配置後には、さまざまな原因でこのイベントが発生する可能性がありますが、そのほとんどが電子メール アドレスのエラーに関係しています。

e パラメータとして渡されたオブジェクトの Handled プロパティを true に設定して、例外が処理されたことを通知する必要があります。この通知を行わないと、例外が再度スローされます。

イベントが発生すると、デリゲートを使用してイベント ハンドラが呼び出されます。詳細については、「ASP.NET Web ページのサーバー イベント処理」を参照してください。

OnSendMailError メソッドを使用すると、デリゲートを結び付けずに、派生クラスでイベントを処理することもできます。派生クラスでイベントを処理する場合は、この手法をお勧めします。

継承時の注意 派生クラスで OnSendMailError メソッドをオーバーライドする場合は、登録されているデリゲートがイベントを受け取ることができるように、基本クラスの OnSendMailError メソッドを呼び出してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
PasswordRecovery クラス
PasswordRecovery メンバ
System.Web.UI.WebControls 名前空間
SendMailErrorEventArgs
SendMailError
OnBubbleEvent
その他の技術情報
ASP.NET Web ページのサーバー イベント処理
ASP.NET ログイン コントロールの概要
ASP.NET ログイン コントロールの外観のカスタマイズ
方法 : 匿名ユーザーおよびログイン ユーザーに異なる情報を表示する
Web サイト管理ツールの [セキュリティ] タブ
ログイン コントロールのセキュリティ保護
Web アプリケーションのセキュリティに関する基本的な対策
メンバシップのセキュリティ保護