CreateUserWizard.OnSendingMail(MailMessageEventArgs) CreateUserWizard.OnSendingMail(MailMessageEventArgs) CreateUserWizard.OnSendingMail(MailMessageEventArgs) CreateUserWizard.OnSendingMail(MailMessageEventArgs) Method

定義

新規ユーザーに電子メール メッセージが送信される前に、SendingMail イベントを発生させます。Raises the SendingMail event before an email message is sent to a new user.

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 MailMessageEventArgs MailMessageEventArgs

イベント データを格納している MailMessageEventArgsA MailMessageEventArgs containing the event data.

次のコード例では、 CreateUserWizard OnSendingMailメソッドを使用して、新しいユーザーに送信される電子メールのテキストを変更するカスタムコントロールを定義します。The following code example defines a custom CreateUserWizard control that uses the OnSendingMail method to modify the text of the email sent to new users. この例では、次のテキストを含む MailFile という名前のテキストファイルが必要です。This example requires a text file named MailFile.txt that contains the following text.

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メソッドを使用して、新しいユーザーに送信される電子メールメッセージを変更します。Use the OnSendingMail method to modify the email message sent to new users. パラメーターとしてMailMessageEventArgs 渡されMailMessageたオブジェクトのプロパティには、新しいユーザーに送信されるオブジェクトが含まれます。Message eThe Message property of the MailMessageEventArgs object passed as the e parameter contains the MailMessage object that will be sent to the new user. 電子メールメッセージを変更MailMessageするには、オブジェクトのプロパティを変更します。Modify the properties of the MailMessage object to modify the email message.

電子メールメッセージは、 BodyFileName MailDefinitionプロパティによって指定MailDefinitionされたオブジェクトのプロパティが有効なファイル名を指している場合にのみ作成されます。Email messages are only created when the BodyFileName property of the MailDefinition object specified by the MailDefinition property points to a valid file name.

イベントを発生させると、イベント ハンドラーがデリゲートから呼び出されます。Raising an event invokes the event handler through a delegate. 詳細については、次を参照してください。処理とイベントの発生します。For more information, see Handling and Raising Events.

OnSendingMail メソッドを使用すると、デリゲートを結び付けずに、派生クラスでイベントを処理することもできます。The OnSendingMail method also allows derived classes to handle the event without attaching a delegate. 派生クラスでイベントを処理する場合は、この手法をお勧めします。This is the preferred technique for handling the event in a derived class.

注意 (継承者)

派生クラスOnSendingMail(MailMessageEventArgs)でをオーバーライドする場合は、登録されているデリゲートOnSendingMail(MailMessageEventArgs)がイベントを受け取るように、基本クラスのメソッドを呼び出す必要があります。When overriding OnSendingMail(MailMessageEventArgs) in a derived class, be sure to call the base class' OnSendingMail(MailMessageEventArgs) method so that registered delegates receive the event.

適用対象

こちらもご覧ください