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。

例

次のコード例では、 メソッドを使用OnSendingMailして新しいユーザーに送信される電子メールのテキストを変更するカスタム CreateUserWizard コントロールを定義します。 この例では、次のテキストを含む 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パラメーターとしてe渡されるオブジェクトの MailMessageEventArgs プロパティには、新しいユーザーに送信されるオブジェクトが含まれますMailMessage。 電子メール メッセージを変更するには、 MailMessage オブジェクトのプロパティを変更します。

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

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

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

注意 (継承者)

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

適用対象

こちらもご覧ください