CreateUserWizard.OnSendingMail(MailMessageEventArgs) メソッド

定義

名前空間:
System.Web.UI.WebControls
アセンブリ:
System.Web.dll

電子メール メッセージが新しいユーザーに送信される前に、 SendingMail イベントを発生させます。

protected:
 virtual void OnSendingMail(System::Web::UI::WebControls::MailMessageEventArgs ^ e);
protected virtual void OnSendingMail(System.Web.UI.WebControls.MailMessageEventArgs e);
abstract member OnSendingMail : System.Web.UI.WebControls.MailMessageEventArgs -> unit
override this.OnSendingMail : System.Web.UI.WebControls.MailMessageEventArgs -> unit
Protected Overridable Sub OnSendingMail (e As MailMessageEventArgs)

パラメーター

e
MailMessageEventArgs

イベント データを含む MailMessageEventArgs 。

例

次のコード例では、CreateUserWizard メソッドを使用して新しいユーザーに送信される電子メールのテキストを変更するカスタム OnSendingMail コントロールを定義します。 この例では、次のテキストを含む MailFile.txt という名前のテキスト ファイルが必要です。

Your account was set up on our Web site with the following:

    Username:   <%UserName%>

To reset your password, you must answer the following question:

    Password Question: <%PasswordQuestion%>
    Password Answer:   <%PasswordAnswer%>

Thank you for creating an account with our Web site.

<%@ Page Language="C#"%>
<%@ Import namespace="Samples.AspNet.CS.Controls" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
private void Page_Load(object sender, EventArgs e) {    
    Placeholder1.Controls.Add(new CustomCreateUserWizard());
}
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>CreateUserWizard.OnSendingMail sample</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:placeholder id="Placeholder1" runat="server" >
      </asp:placeholder>
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB"%>
<%@ Import namespace="Samples.AspNet.VB.Controls" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
    Dim createUser As New CustomCreateUserWizard
    Placeholder1.Controls.Add(createUser)
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>CreateUserWizard.OnSendingMail sample</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:placeholder id="Placeholder1" runat="server" >
      </asp:placeholder>
    </div>
    </form>
</body>
</html>

注釈

OnSendingMailメソッドを使用して、新しいユーザーに送信される電子メール メッセージを変更します。 Message パラメーターとして渡されるMailMessageEventArgs オブジェクトのe プロパティには、新しいユーザーに送信されるMailMessage オブジェクトが含まれています。 電子メール メッセージを変更するには、 MailMessage オブジェクトのプロパティを変更します。

電子メール メッセージは、BodyFileName プロパティで指定されたMailDefinition オブジェクトのMailDefinition プロパティが有効なファイル名を指している場合にのみ作成されます。

イベントを発生させると、デリゲートを介してイベント ハンドラーが呼び出されます。 詳細については、「イベントの 処理と発生」を参照してください。

OnSendingMail メソッドでは、デリゲートをアタッチせずに、派生クラスでイベントを処理することもできます。 これは、派生クラスでイベントを処理するために推奨される手法です。

注意 (継承者)

派生クラスで OnSendingMail(MailMessageEventArgs) をオーバーライドする場合は、登録されているデリゲートがイベントを受け取るように、基底クラスの OnSendingMail(MailMessageEventArgs) メソッドを必ず呼び出してください。

適用対象

こちらもご覧ください