PasswordRecovery.OnSendingMail(MailMessageEventArgs) メソッド

定義

SendingMail イベントを発生させます。Raises the SendingMail event.

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

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

次のコード例では、 PasswordRecovery OnSendingMail MailDefinition Web サイトユーザーに新しいパスワードを送信する前に、メソッドを実装してプロパティのプロパティを設定するカスタムコントロールを作成します。The following code example creates a custom PasswordRecovery control that implements the OnSendingMail method to set properties of the MailDefinition property before sending a new password to a Web site user.

<%@ 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">

  void Page_Init(object sender, EventArgs e)
  {
    PasswordRecoveryOnBeforeSendingEmail passwordRecoveryControl = 
      new PasswordRecoveryOnBeforeSendingEmail();

    passwordRecoveryControl.ID = "passwordRecoveryControl";
    passwordRecoveryControl.MailDefinition.From = "userAdmin@your.site.name.here";
    PlaceHolder1.Controls.Add(passwordRecoveryControl);

  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:placeholder id="PlaceHolder1" runat="server"></asp:placeholder>
    </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_Init(ByVal sender As Object, ByVal e As EventArgs)
    
    Dim passwordRecoveryControl As New PasswordRecoveryOnBeforeSendingEmail
        
    passwordRecoveryControl.ID = "passwordRecoveryControl"
    passwordRecoveryControl.MailDefinition.From = "userAdmin@your.site.name.here"
    PlaceHolder1.Controls.Add(passwordRecoveryControl)
        
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:placeholder id="PlaceHolder1" runat="server"></asp:placeholder>
    </form>
  </body>
</html>

注釈

OnSendingMailメソッドは、メンバーシッププロバイダーによって、ユーザーが Web サイトの有効なメンバーであることを確認した後、回復したパスワードまたは新しいパスワードがユーザーに電子メールで送信される前に呼び出されます。The OnSendingMail method is called after the membership provider has verified that the user is a valid member of the Web site and before the recovered or new password is emailed to the user. 既定の実装では、イベントが発生し SendingMail ます。The default implementation raises the SendingMail event.

イベントを発生させると、イベント ハンドラーがデリゲートから呼び出されます。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's OnSendingMail(MailMessageEventArgs) method so that registered delegates receive the event.

適用対象

こちらもご覧ください