EmbeddedMailObject

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

EmbeddedMailObject クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

MailDefinition クラスを使用して構築した電子メール メッセージに埋め込まれる項目を表します。

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

Visual Basic (宣言)

Public NotInheritable Class
 EmbeddedMailObject

Visual Basic (使用法)

Dim instance As EmbeddedMailObject

C#

public sealed class EmbeddedMailObject

C++

public ref class EmbeddedMailObject sealed

J#

public final class EmbeddedMailObject

JScript

public final class EmbeddedMailObject

解説

EmbeddedMailObject は、メール メッセージに埋め込まれる項目を表します。埋め込まれる項目には、企業のロゴなどのイメージ ファイルがあります。それぞれの埋め込み項目は、ID と絶対パスで指定します。

埋め込まれたオブジェクトが確実に電子メール メッセージ内で正しく表示されるようにするには、次の条件を満たす必要があります。

• メール メッセージが HTML 形式である。

• 項目がイメージ ファイル (.jpg、.gif、.bmp など) である。

• BodyFileName プロパティに指定された HTML 形式の本文ファイルに、次の構文を使用したイメージ ファイルへの参照が含まれる。

  <img src="https://cdn.weblio.jp/e7/img/dict/msdnc/he4xhktd.note(ja-jp,VS.80).gif" />メモ  
   EmbeddedMailObject オブジェクトおよび EmbeddedMailObjectsCollection オブジェクトの値は、ビューステートに保存されません。これにより、悪意あるユーザーがサーバーのパス情報を調べることを防ぎます。
    
  				

  使用例
  

  ChangePassword Web コントロールを使用し、SendingMail という名前の SendingMail イベントのイベント ハンドラを含む ASP.NET ページを次のコード例に示します。このコード例では、ASP.NET メンバシップとフォーム認証を使用するように構成された ASP.NET Web サイトと、名前とパスワードがわかっているユーザーが作成されていることを前提にしています。詳細については、「方法 : 簡単なフォーム認証を実装する」を参照してください。

  パスワードの変更に成功した場合、SendingMail イベント ハンドラのコードは、変更内容を確認する電子メール メッセージをユーザーに送信します。このコード例を実行するには、あらかじめサーバー上で SMTP を構成しておく必要があります。SMTP サーバーを構成する方法については、「方法 : IIS 内で SMTP 仮想サーバーをインストールおよび構成する」を参照してください。この例の目的では、必ずしも SMTP サーバーを構成する必要はありません。この例は、電子メール メッセージの送信エラーをテストするために構築されています。

  メール サーバーが正しく構成されていない場合、または他のエラーが発生して、電子メール メッセージを送信できない場合、SendMailError 関数が呼び出されます。ユーザーにメッセージが表示されます。さらに、MySamplesSite という名前のイベント ソースが既に存在するという前提で、Windows のアプリケーション イベント ログにイベントが記録されます。指定されたイベント ソースを作成するには、下記のコード例を参照してください。イベント ソースの作成の詳細については、「ASP.NET Web ページのサーバー イベント処理」を参照してください。エラーが処理されたことを示すために、SendMailErrorEventArgs オブジェクトの Handled プロパティは true に設定されます。

  Visual Basic

  <%@ Page Language="VB" AutoEventWireup="True"
   %>
  
  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML
   1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  
  <script runat="server">
  
    Public Sub MySendingMail(ByVal
   Sender As Object, ByVal
   e As MailMessageEventArgs)
      Message1.Text = "Sent mail to you to confirm the password
   change."
    End Sub
  
    Public Sub MySendMailError(ByVal
   Sender As Object, ByVal
   e As SendMailErrorEventArgs)
      Message1.Text = "Could not send mail to confirm the password
   change."
      
      ' The MySamplesSite event source has already been created by an
   administrator.
      Dim myLog As System.Diagnostics.EventLog
      myLog = new System.Diagnostics.EventLog
      myLog.Log = "Application"
      myLog.Source = "MySamplesSite"
      myLog.WriteEntry("Sending mail via SMTP failed with the following
   error: " & e.Exception.Message.ToString(), System.Diagnostics.EventLogEntryType.Error)
  
      e.Handled = True
      
    End Sub
  
  </script>
  
  <html  >
  <head runat="server">
    <title>ChangePassword including a SendMailError Event</title>
  </head>
  <body>
    <form id="form1" runat="server">
    <div align="center">
  
      <h1>ChangePassword</h1>
      
      <asp:LoginView ID="LoginView1" Runat="server"
   
        Visible="true">
        <LoggedInTemplate>
          <asp:LoginName ID="LoginName1" Runat="server"
   FormatString="You are logged in as {0}." />
          <BR />
        </LoggedInTemplate>
        <AnonymousTemplate>
          You are not logged in
        </AnonymousTemplate>
      </asp:LoginView><br />
      
      <asp:ChangePassword ID="ChangePassword1" Runat="server"
        BorderStyle="Solid" 
        BorderWidth="1" 
        CancelDestinationPageUrl="~/Default.aspx" 
        DisplayUserName="true"
        OnSendingMail="MySendingMail" 
        OnSendMailError="MySendMailError" 
        ContinueDestinationPageUrl="~/Default.aspx"
   >
        <MailDefinition 
          BodyFileName="~\MailFiles\ChangePasswordMail.htm"
   
          Subject="Activity information for you">
          <EmbeddedObjects>
            <asp:EmbeddedMailObject Name="LoginGif"
   Path="~\MailFiles\Login.gif" />
            <asp:EmbeddedMailObject Name="PrivacyNoticeTxt"
   Path="~\MailFiles\PrivacyNotice.txt" />
          </EmbeddedObjects>
        </MailDefinition>
      </asp:ChangePassword><br />
    
      <asp:Label ID="Message1" Runat="server"
   ForeColor="Red" /><br />
  
      <asp:HyperLink ID="HyperLink1" Runat="server"
   
        NavigateUrl="~/Default.aspx">
        Home
      </asp:HyperLink>
      
    </div>
    </form>
  </body>
  </html>
  

  C#

  <%@ Page Language="C#" AutoEventWireup="True" %>
  
  <script runat="server">
  
    void MySendingMail(object sender, MailMessageEventArgs e)
    {
      Message1.Text = "Sent mail to you to confirm the password change.";
    }
  
    void MySendMailError(object sender, SendMailErrorEventArgs e)
    {
      Message1.Text = "Could not send email to confirm password change.";
  
      // The MySamplesSite event source has already been created by an
   administrator.
      System.Diagnostics.EventLog myLog = new System.Diagnostics.EventLog();
      myLog.Log = "Application";
      myLog.Source = "MySamplesSite";
      myLog.WriteEntry(
          "Sending mail via SMTP failed with the following error: " + 
          e.Exception.Message.ToString(), 
          System.Diagnostics.EventLogEntryType.Error);
  
      e.Handled = true;
    }
  
  </script>
  
  <html  >
  <head runat="server">
    <title>ChangePassword including a SendMailError Event</title>
  </head>
  <body>
    <form id="form1" runat="server">
    <div align="center">
  
      <h1>ChangePassword</h1>
      
      <asp:LoginView ID="LoginView1" Runat="server" 
        Visible="true">
        <LoggedInTemplate>
          <asp:LoginName ID="LoginName1" Runat="server" FormatString="You
   are logged in as {0}." />
          <BR />
        </LoggedInTemplate>
        <AnonymousTemplate>
          You are not logged in
        </AnonymousTemplate>
      </asp:LoginView><br />
      
      <asp:ChangePassword ID="ChangePassword1" Runat="server"
        BorderStyle="Solid" 
        BorderWidth="1" 
        CancelDestinationPageUrl="~/Default.aspx" 
        DisplayUserName="true"
        OnSendingMail="MySendingMail" 
        OnSendMailError="MySendMailError" 
        ContinueDestinationPageUrl="~/Default.aspx" >
        <MailDefinition 
          BodyFileName="~\MailFiles\ChangePasswordMail.htm" 
          Subject="Activity information for you">
          <EmbeddedObjects>
            <asp:EmbeddedMailObject Name="LoginGif" Path="~\MailFiles\Login.gif"
   />
            <asp:EmbeddedMailObject Name="PrivacyNoticeTxt" Path="~\MailFiles\PrivacyNotice.txt"
   />
          </EmbeddedObjects>
        </MailDefinition>
      </asp:ChangePassword><br />
    
      <asp:Label ID="Message1" Runat="server" ForeColor="Red"
   /><br />
  
      <asp:HyperLink ID="HyperLink1" Runat="server" 
        NavigateUrl="~/Default.aspx">
        Home
      </asp:HyperLink>
      
    </div>
    </form>
  </body>
  </html>
  

  MySamplesSite という名前のイベント ソースをプログラムによってアプリケーション ログに追加する必要がある場合は、次のコード例を使用します。最初のコード例を正常に動作させるには、このイベント ソースが存在する必要があります。次のコード例には、管理者特権が必要です。

  Visual Basic

  Imports System
  Imports System.Collections.Generic
  Imports System.Text
  Imports System.Diagnostics
  
  
  Namespace CreateEventSource
    Class Program
      Sub Main()
  
          Try
              ' Create the source, if it does not already exist.
              If Not (EventLog.SourceExists("MySamplesSite"))
   Then
                  EventLog.CreateEventSource("MySamplesSite",
   "Application")
                  Console.WriteLine("Creating Event Source")
              End If
  
              ' Create an EventLog instance and assign its source.
              Dim myLog As New
   EventLog
              myLog.Source = "MySamplesSite"
  
              ' Write an informational entry to the event log.
              myLog.WriteEntry("Testing writing to event log.")
  
              Console.WriteLine("Message written to event log.")
          Catch e As Exception
              Console.WriteLine("Exception:")
              Console.WriteLine(e.ToString)
          End Try
  
      End Sub
    End Class
  End Namespace
  

  C#

  #region Using directives
  
  using System;
  using System.Collections.Generic;
  using System.Text;
  using System.Diagnostics;
  
  #endregion
  
  namespace CreateEventSource
  {
      class Program
      {
          static void Main(string[]
   args)
          {
  
              try
              {
                  // Create the source, if it does not already exist.
                  if (!EventLog.SourceExists("MySamplesSite"))
                  {
                      EventLog.CreateEventSource("MySamplesSite", "Application");
                      Console.WriteLine("Creating Event Source");
                  }
  
                  // Create an EventLog instance and assign its source.
                  EventLog myLog = new EventLog();
                  myLog.Source = "MySamplesSite";
  
                  // Write an informational entry to the event log.  
    
                  myLog.WriteEntry("Testing writing to event log.");
  
                  Console.WriteLine("Message written to event log.");
              }
              catch (Exception e)
              {
                  Console.WriteLine("Exception:");
                  Console.WriteLine("{0}", e.ToString());
              }
          }
      }
  }
  

  次のコード例は、前のコード例の ChangePasswordMail.htm ファイルとして使用できます。

  セキュリティに関するメモ
  ユーザーのアカウント名またはパスワードを電子メールで送信すると、セキュリティが脆弱になる可能性があります。通常、電子メール メッセージは平文で送信され、特殊なネットワーク "スニッフィング" アプリケーションで読み取られる可能性があります。セキュリティを強化するには、「ログイン コントロールのセキュリティ保護」に記述されているリスク軽減策を使用します。

  <html>
  <head><title></title></head>
  <body>
  <form>
  
    <h1>Your password for the account named &quot;<%Username%>&quot;
   has changed.</h1>
  
    <p>
    If you did not initiate this change, please call 1-206-555-0100.
    </p>
    
    <p>
    <a href="http://www.contoso.com/login.aspx">
      <img src="https://cdn.weblio.jp/e7/img/dict/msdnc/cid:LoginGif" alt="Log In" />
    </a> 
    </p>
    
    <p>
    Please read our attached Privacy Notice.
    </p>
  
  </form>
  </body>
  </html>
  

  .NET Framework のセキュリティ
  
  • AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)要求値 : LinkDemand; アクセス許可値 : Minimal。
  継承階層
  
  System.Object
    System.Web.UI.WebControls.EmbeddedMailObject
  
  スレッド セーフ
  
  この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
  プラットフォーム
  

  Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

  開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

  バージョン情報
  
  .NET Framework
  サポート対象 : 2.0
  
  参照
  
  関連項目
  EmbeddedMailObject メンバ
  System.Web.UI.WebControls 名前空間
  EmbeddedObjects
  CreateUserWizard クラス
  CreateUserWizard.MailDefinition プロパティ
  CreateUserWizard.SendingMail イベント
  ChangePassword クラス
  ChangePassword.MailDefinition プロパティ
  ChangePassword.SendingMail イベント
  PasswordRecovery
  MailDefinition
  SendingMail
  MailMessage
  その他の技術情報
  Web サイト管理ツールの [アプリケーション] タブ
  

EmbeddedMailObject コンストラクタ ()

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

EmbeddedMailObject クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New EmbeddedMailObject

C#

public EmbeddedMailObject ()

C++

public:
EmbeddedMailObject ()

J#

public EmbeddedMailObject ()

JScript

public function EmbeddedMailObject ()

解説

埋め込み項目の ID を取得または設定するには、Name プロパティを使用します。埋め込み項目へのパスを取得または設定するには、Path プロパティを使用します。メール メッセージに正常に項目を埋め込むには、両方のプロパティを設定する必要があります。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
EmbeddedMailObject クラス
EmbeddedMailObject メンバ
System.Web.UI.WebControls 名前空間
EmbeddedObjects
その他の技術情報
Web サイト管理ツールの [アプリケーション] タブ
方法 : IIS 内で SMTP 仮想サーバーをインストールおよび構成する

EmbeddedMailObject コンストラクタ

EmbeddedMailObject クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
EmbeddedMailObject ()	EmbeddedMailObject クラスの新しいインスタンスを初期化します。
EmbeddedMailObject (String, String)	識別名とオブジェクトを読み込むパスを指定して、EmbeddedMailObject クラスの新しいインスタンスを初期化します。

参照

関連項目

EmbeddedMailObject クラス
EmbeddedMailObject メンバ
System.Web.UI.WebControls 名前空間
EmbeddedObjects

その他の技術情報

Web サイト管理ツールの [アプリケーション] タブ
方法 : IIS 内で SMTP 仮想サーバーをインストールおよび構成する

EmbeddedMailObject コンストラクタ (String, String)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

識別名とオブジェクトを読み込むパスを指定して、EmbeddedMailObject クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    name As String, _
    path As String _
)

Visual Basic (使用法)

Dim name As String
Dim path As String

Dim instance As New EmbeddedMailObject(name,
 path)

C#

public EmbeddedMailObject (
    string name,
    string path
)

C++

public:
EmbeddedMailObject (
    String^ name, 
    String^ path
)

J#

public EmbeddedMailObject (
    String name, 
    String path
)

JScript

public function EmbeddedMailObject (
    name : String, 
    path : String
)

パラメータ

name

メール メッセージに埋め込む項目の ID として使用する名前。詳細については、「Name」を参照してください。

path

メール メッセージに埋め込む項目を取得するために使用するパス。詳細については、「Path」を参照してください。

使用例

ChangePassword コントロールを使用し、SendingMail という名前の SendingMail イベントのイベント ハンドラを含む、ASP.NET ページの分離コードの例を次のコード例に示します。このコード例では、ASP.NET メンバシップとフォーム認証を使用するように構成された ASP.NET Web サイトと、名前とパスワードがわかっているユーザーが作成されていることを前提にしています。詳細については、「方法 : 簡単なフォーム認証を実装する」を参照してください。

パスワードの変更に成功した場合、SendingMail イベント ハンドラのコードは、変更内容を確認する電子メール メッセージをユーザーに送信します。このコード例を実行するには、あらかじめサーバー上で SMTP を構成しておく必要があります。SMTP サーバーを構成する方法については、「方法 : IIS 内で SMTP 仮想サーバーをインストールおよび構成する」を参照してください。この例の目的では、必ずしも SMTP サーバーを構成する必要はありません。この例は、電子メール メッセージの送信エラーをテストするために構築されています。

メール サーバーが正しく構成されていない場合、または他のエラーが発生して、電子メール メッセージを送信できない場合、SendMailError 関数が呼び出されます。ユーザーにメッセージが表示されます。さらに、MySamplesSite という名前のイベント ソースが既に存在するという前提で、Windows のアプリケーション イベント ログにイベントが記録されます。指定されたイベント ソースを作成するには、下記のコード例を参照してください。イベント ソースの作成の詳細については、「ASP.NET Web ページのサーバー イベント処理」を参照してください。エラーが処理されたことを示すために、SendMailErrorEventArgs オブジェクトの Handled プロパティは true に設定されます。

.aspx ページを使用するコード例を次に示します。

Visual Basic

<%@ Page Language="VB" AutoEventWireup="true"
 CodeFile="ChangePassword.vb" Inherits="ChangePassword_vb_aspx"
 %>

<html  >
<head runat="server">
  <title>ChangePassword using code-behind including a SendMailError Event</title>
</head>
<body>
  <form id="form1" runat="server">
  <div align="center">

    <h1>ChangePassword</h1>
    
    <asp:LoginView ID="LoginView1" Runat="server"
 
      Visible="true">
      <LoggedInTemplate>
        <asp:LoginName ID="LoginName1" Runat="server"
 FormatString="You are logged in as {0}." />
        <BR />
      </LoggedInTemplate>
      <AnonymousTemplate>
        You are not logged in
      </AnonymousTemplate>
    </asp:LoginView><br />
    
    <asp:ChangePassword ID="ChangePassword1" Runat="server"
      BorderStyle="Solid" 
      BorderWidth="1" 
      CancelDestinationPageUrl="~/Default.aspx" 
      DisplayUserName="true"
      ContinueDestinationPageUrl="~/Default.aspx"
      OnSendingMail="_SendingMail" 
      OnSendMailError="_SendMailError" >
    </asp:ChangePassword><br />
  
    <asp:Label ID="Message1" Runat="server"
 ForeColor="Red" /><br />

    <asp:HyperLink ID="HyperLink1" Runat="server"
 
      NavigateUrl="~/Default.aspx">
      Home
    </asp:HyperLink>
    
  </div>
  </form>
</body>
</html>

C#

<%@ Page Language="C#" CodeFile="ChangePassword.cs" Inherits="ChangePassword_cs_aspx"
 %>

<html  >
<head id="Head1" runat="server">
  <title>ChangePassword using code-behind including a SendMailError
 Event</title>
</head>
<body>
  <form id="form1" runat="server">
  <div align="center">

    <h1>ChangePassword</h1>
    
    <asp:LoginView ID="LoginView1" Runat="server" 
      Visible="true">
      <LoggedInTemplate>
        <asp:LoginName ID="LoginName1" Runat="server" FormatString="You
 are logged in as {0}." />
        <BR />
      </LoggedInTemplate>
      <AnonymousTemplate>
        You are not logged in
      </AnonymousTemplate>
    </asp:LoginView><br />
    
    <asp:ChangePassword ID="ChangePassword1" Runat="server"
      BorderStyle="Solid" 
      BorderWidth="1" 
      CancelDestinationPageUrl="~/Default.aspx" 
      DisplayUserName="true"
      ContinueDestinationPageUrl="~/Default.aspx" >
    </asp:ChangePassword><br />
  
    <asp:Label ID="Message1" Runat="server" ForeColor="Red"
 /><br />

    <asp:HyperLink ID="HyperLink1" Runat="server" 
      NavigateUrl="~/Default.aspx">
      Home
    </asp:HyperLink>
    
  </div>
  </form>
</body>
</html>

分離コード ファイルを使用するコード例に次に示します。

Visual Basic

Imports System
Imports System.Data
Imports System.Configuration
Imports System.Web
Imports System.Web.Security
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.HtmlControls
Imports Microsoft.VisualBasic

Partial Class ChangePassword_vb_aspx
    Inherits System.Web.UI.Page

    Protected Sub Page_Load(ByVal
 Sender As Object, ByVal
 e As System.EventArgs)
        AddHandler ChangePassword1.SendingMail, AddressOf
 Me._SendingMail
        AddHandler ChangePassword1.SendMailError, AddressOf
 Me._SendMailError
        ChangePassword1.MailDefinition.BodyFileName = "~/Attachments/ChangePasswordMail.htm"
        ChangePassword1.MailDefinition.Cc = "someone@example.com"
        ChangePassword1.MailDefinition.From = "someone@example.com"

        Dim loginGif As New
 EmbeddedMailObject
        loginGif.Name = "LoginGif"
        loginGif.Path = "~/Attachments/Login.gif"

        Dim privacyNoticeTxt As New
 EmbeddedMailObject
        privacyNoticeTxt.Name = "PrivacyNoticeTxt"
        privacyNoticeTxt.Path = "~/Attachments/PrivacyNotice.txt"

        ChangePassword1.MailDefinition.EmbeddedObjects.Add(loginGif)
        ChangePassword1.MailDefinition.EmbeddedObjects.Add(privacyNoticeTxt)
    End Sub

    Protected Sub _SendingMail(ByVal
 Sender As Object, ByVal
 e As MailMessageEventArgs)
        Message1.Visible = True
        Message1.Text = "Sent mail to you to confirm the password
 change."

        e.Message.Subject = "Activity information for you"
        e.Message.IsBodyHtml = True

    End Sub

    Protected Sub _SendMailError(ByVal
 Sender As Object, ByVal
 e As SendMailErrorEventArgs)
        Message1.Visible = True
        Message1.Text = "Could not send mail to confirm the password
 change."

        ' The MySamplesSite event source has already been created by
 an administrator.
        Dim myLog As System.Diagnostics.EventLog
        myLog = New System.Diagnostics.EventLog
        myLog.Log = "Application"
        myLog.Source = "MySamplesSite"
        myLog.WriteEntry("Sending mail via SMTP failed with the
 following error: " & e.Exception.Message.ToString(), System.Diagnostics.EventLogEntryType.Error)

        e.Handled = True

    End Sub

End Class

C#

using System;
using System.Data;
using System.Configuration;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.HtmlControls;

public partial class ChangePassword_cs_aspx
 : System.Web.UI.Page
{
    protected void Page_Load(Object sender,
 EventArgs e)
    {
        // Manually register the event-handling methods.
        ChangePassword1.SendingMail += new MailMessageEventHandler(this._SendingMail);
        ChangePassword1.SendMailError += new SendMailErrorEventHandler(this._SendMailError);

        ChangePassword1.MailDefinition.BodyFileName = "~/Attachments/ChangePasswordMail.htm";

        EmbeddedMailObject loginGif = new EmbeddedMailObject();
        loginGif.Name = "LoginGif";
        loginGif.Path = "~/Attachments/Login.gif";

        EmbeddedMailObject privacyNoticeTxt = new EmbeddedMailObject();
        privacyNoticeTxt.Name = "PrivacyNoticeTxt";
        privacyNoticeTxt.Path = "~/Attachments/PrivacyNotice.txt";

        ChangePassword1.MailDefinition.EmbeddedObjects.Add(loginGif);
        ChangePassword1.MailDefinition.EmbeddedObjects.Add(privacyNoticeTxt);
    }

    protected void _SendingMail(object sender,
 MailMessageEventArgs e)
    {
        Message1.Visible = true;
        Message1.Text = "Sent mail to you to confirm the password change.";

        System.Net.Mail.MailAddress from = new System.Net.Mail.MailAddress("someone@example.com",
 "Someone");
        System.Net.Mail.MailAddress copy = new System.Net.Mail.MailAddress("someone@example.com",
 "Someone");

        e.Message.From = from;
        e.Message.CC.Add(copy);
        e.Message.Subject = "Activity information for you";
        e.Message.IsBodyHtml = true;
    }

    protected void _SendMailError(object sender,
 SendMailErrorEventArgs e)
    {
        Message1.Visible = true;
        Message1.Text = "Could not send email to confirm password change.";

        // The MySamplesSite event source has already been created by
 an administrator.
        System.Diagnostics.EventLog myLog = new System.Diagnostics.EventLog();
        myLog.Source = "MySamplesSite";
        myLog.Log = "Application";
        myLog.WriteEntry(
          "Sending mail via SMTP failed with the following error: " +
          e.Exception.Message.ToString(),
          System.Diagnostics.EventLogEntryType.Error);

        e.Handled = true;
    }
}

MySamplesSite という名前のイベント ソースをプログラムによってアプリケーション ログに追加する必要がある場合は、次のコード例を使用します。最初のコード例を正常に実行するには、このイベント ソースが存在する必要があります。次のコード例には、管理者特権が必要です。

Visual Basic

Imports System
Imports System.Collections.Generic
Imports System.Text
Imports System.Diagnostics


Namespace CreateEventSource
  Class Program
    Sub Main()

        Try
            ' Create the source, if it does not already exist.
            If Not (EventLog.SourceExists("MySamplesSite"))
 Then
                EventLog.CreateEventSource("MySamplesSite",
 "Application")
                Console.WriteLine("Creating Event Source")
            End If

            ' Create an EventLog instance and assign its source.
            Dim myLog As New
 EventLog
            myLog.Source = "MySamplesSite"

            ' Write an informational entry to the event log.
            myLog.WriteEntry("Testing writing to event log.")

            Console.WriteLine("Message written to event log.")
        Catch e As Exception
            Console.WriteLine("Exception:")
            Console.WriteLine(e.ToString)
        End Try

    End Sub
  End Class
End Namespace

C#

#region Using directives

using System;
using System.Collections.Generic;
using System.Text;
using System.Diagnostics;

#endregion

namespace CreateEventSource
{
    class Program
    {
        static void Main(string[]
 args)
        {

            try
            {
                // Create the source, if it does not already exist.
                if (!EventLog.SourceExists("MySamplesSite"))
                {
                    EventLog.CreateEventSource("MySamplesSite", "Application");
                    Console.WriteLine("Creating Event Source");
                }

                // Create an EventLog instance and assign its source.
                EventLog myLog = new EventLog();
                myLog.Source = "MySamplesSite";

                // Write an informational entry to the event log.  
  
                myLog.WriteEntry("Testing writing to event log.");

                Console.WriteLine("Message written to event log.");
            }
            catch (Exception e)
            {
                Console.WriteLine("Exception:");
                Console.WriteLine("{0}", e.ToString());
            }
        }
    }
}

次のコード例は、前のコード例の ChangePasswordMail.htm ファイルとして使用できます。

セキュリティに関するメモ
ユーザー アカウント名やパスワードを電子メール メッセージで送信すると、セキュリティが脆弱になる可能性があります。通常、電子メール メッセージは平文で送信され、特殊なネットワーク "スニッフィング" アプリケーションで読み取られる可能性があります。セキュリティを強化するには、「ログイン コントロールのセキュリティ保護」に記述されているリスク軽減策を使用します。

<html>
<head><title></title></head>
<body>
<form>

  <h1>Your password for the account named &quot;<%Username%>&quot;
 has changed.</h1>

  <p>
  If you did not initiate this change, please call 1-206-555-0100.
  </p>
  
  <p>
  <a href="http://www.contoso.com/login.aspx">
    <img src="https://cdn.weblio.jp/e7/img/dict/msdnc/cid:LoginGif" alt="Log In" />
  </a> 
  </p>
  
  <p>
  Please read our attached Privacy Notice.
  </p>

</form>
</body>
</html>

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
EmbeddedMailObject クラス
EmbeddedMailObject メンバ
System.Web.UI.WebControls 名前空間
EmbeddedObjects
SmtpMail
その他の技術情報
Web サイト管理ツールの [アプリケーション] タブ
方法 : IIS 内で SMTP 仮想サーバーをインストールおよび構成する

EmbeddedMailObject プロパティ

パブリック プロパティ

	名前	説明
	Name	MailDefinition クラスを使用して構築したメール メッセージに埋め込まれる項目の ID として使用する名前を取得または設定します。
	Path	MailDefinition クラスを使用して構築したメール メッセージに埋め込む項目を取得するために使用するパスを取得または設定します。

参照

関連項目

EmbeddedMailObject クラス
System.Web.UI.WebControls 名前空間
EmbeddedObjects
CreateUserWizard クラス
CreateUserWizard.MailDefinition プロパティ
CreateUserWizard.SendingMail イベント
ChangePassword クラス
ChangePassword.MailDefinition プロパティ
ChangePassword.SendingMail イベント
PasswordRecovery
MailDefinition
SendingMail
MailMessage

その他の技術情報

Web サイト管理ツールの [アプリケーション] タブ

EmbeddedMailObject メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

EmbeddedMailObject クラス
System.Web.UI.WebControls 名前空間
EmbeddedObjects
CreateUserWizard クラス
CreateUserWizard.MailDefinition プロパティ
CreateUserWizard.SendingMail イベント
ChangePassword クラス
ChangePassword.MailDefinition プロパティ
ChangePassword.SendingMail イベント
PasswordRecovery
MailDefinition
SendingMail
MailMessage

その他の技術情報

Web サイト管理ツールの [アプリケーション] タブ

EmbeddedMailObject メンバ

MailDefinition クラスを使用して構築した電子メール メッセージに埋め込まれる項目を表します。

EmbeddedMailObject データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	EmbeddedMailObject	オーバーロードされます。 EmbeddedMailObject クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	Name	MailDefinition クラスを使用して構築したメール メッセージに埋め込まれる項目の ID として使用する名前を取得または設定します。
	Path	MailDefinition クラスを使用して構築したメール メッセージに埋め込む項目を取得するために使用するパスを取得または設定します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

EmbeddedMailObject クラス
System.Web.UI.WebControls 名前空間
EmbeddedObjects
CreateUserWizard クラス
CreateUserWizard.MailDefinition プロパティ
CreateUserWizard.SendingMail イベント
ChangePassword クラス
ChangePassword.MailDefinition プロパティ
ChangePassword.SendingMail イベント
PasswordRecovery
MailDefinition
SendingMail
MailMessage

その他の技術情報

Web サイト管理ツールの [アプリケーション] タブ