MailMessageEventHandler デリゲートとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

MailMessageEventHandler デリゲート

メモ : このデリゲートは、.NET Framework version 2.0 で新しく追加されたものです。

メールイベントを処理するメソッドを表します。

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

Visual Basic (宣言)

Public Delegate Sub MailMessageEventHandler
 ( _
    sender As Object, _
    e As MailMessageEventArgs _
)

Visual Basic (使用法)

Dim instance As New MailMessageEventHandler(AddressOf
 HandlerMethod)

public delegate void MailMessageEventHandler
 (
    Object sender,
    MailMessageEventArgs e
)

C++

public delegate void MailMessageEventHandler
 (
    Object^ sender, 
    MailMessageEventArgs^ e
)

/** @delegate */
public delegate void MailMessageEventHandler
 (
    Object sender, 
    MailMessageEventArgs e
)

JScript

JScript では、デリゲートは使用できますが、新規に宣言することはできません。

パラメータ

sender: イベントのソース。

e: イベントのメールメッセージデータを格納する MailMessageEventArgs。

解説

MailMessageEventHandler デリゲートは、インターネット電子メールメッセージを受信者に送信する前に、そのメッセージの内容を変更します。たとえば、このハンドラを使用して、受信者や Web サイトを識別するカスタムメッセージフッターをすべてのメッセージに追加できます。

e パラメータは、Message プロパティで指定された電子メールメッセージを格納する MailMessageEventArgs インスタンスです。

MailMessageEventHandler デリゲートを作成する場合は、イベントを処理するメソッドを識別してください。イベントをイベントハンドラに関連付けるには、デリゲートのインスタンスをイベントに追加します。デリゲートを削除しない限り、そのイベントが発生すると常にイベントハンドラが呼び出されます。イベントハンドラデリゲートの詳細については、「イベントとデリゲート」を参照してください。

使用例

MailMessageEventHandler インスタンスを作成して、電子メールメッセージを受信者に送信する前にメッセージを変更するコード例を次に示します。

Visual Basic

<%@ page language="VB" %>
<%@ Import namespace="Samples.AspNet.VB.Controls"
 %>

<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>
  <body>
    <form runat="server">
      <asp:placeholder id="PlaceHolder1" runat="server"></asp:placeholder>
    </form>
  </body>
</html>

<%@ page language="C#" %>
<%@ Import namespace="Samples.AspNet.CS.Controls"
 %>

<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>
  <body>
    <form runat="server">
      <asp:placeholder id="PlaceHolder1" runat="server"></asp:placeholder>
    </form>
  </body>
</html>