ChangePassword.MailDefinition プロパティとは何？わかりやすく解説 Weblio辞書

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

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

ChangePassword.MailDefinition プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

ユーザーがパスワードを変更した後にそのユーザーに送信される電子メールメッセージを定義するプロパティのコレクションへの参照を取得します。

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

Visual Basic (宣言)

<ThemeableAttribute(False)> _
Public ReadOnly Property
 MailDefinition As MailDefinition

Visual Basic (使用法)

Dim instance As ChangePassword
Dim value As MailDefinition

value = instance.MailDefinition

[ThemeableAttribute(false)] 
public MailDefinition MailDefinition { get;
 }

C++

[ThemeableAttribute(false)] 
public:
property MailDefinition^ MailDefinition {
    MailDefinition^ get ();
}

/** @property */
public MailDefinition get_MailDefinition ()

JScript

public function get MailDefinition
 () : MailDefinition

プロパティ値
新しいユーザーに送信される電子メールメッセージを定義する MailDefinition オブジェクトへの参照。

例外

例外の種類	条件
HttpException	From プロパティに電子メールアドレスが設定されていません。

解説

MailDefinition プロパティは、パスワードの変更後にユーザーに送信される電子メールメッセージの形式と内容を定義するために使用するプロパティのグループへの参照を返します。一般的な設定としては、件名や送信元の返信用アドレスなどがあります。プロパティの全一覧については、MailDefinition を参照してください。

MailDefinition プロパティは読み取り専用です。ただし、このプロパティが返す MailDefinition オブジェクトのプロパティを設定することはできます。これらのプロパティは、property-subproperty の形式で設定できます。ここで、subproperty は MailDefinition クラスのプロパティを表します (例 : MailDefinition-Subject)。Property.Subproperty の形式でプロパティをプログラムから設定することもできます (例 : MailDefinition.Subject)。

電子メールメッセージが送信されるのは、ユーザーにメンバシッププロバイダに登録済みの電子メールアドレスがあり、MailDefinition プロパティの BodyFileName プロパティが有効なファイルを指定している場合だけです。BodyFileName プロパティを設定する場合は、From プロパティに電子メールアドレスを設定する必要があります。それ以外の場合は、HttpException 例外がスローされます。

MailDefinition オブジェクトから電子メールメッセージを作成すると、次の表に示す置換が行われます。置換テキストの大文字と小文字は区別されません。

置換テキスト	置き換える文字
<% UserName %>	ユーザーの Web サイトユーザー名。
<% Password %>	ユーザーの新しいパスワード。

SendingMail イベントを使用して、MailDefinition オブジェクトによって作成される MailMessage オブジェクトを変更できます。

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

セキュリティに関するメモ

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

このプロパティを、テーマまたはスタイルシートテーマを使用して設定することはできません。詳細については、「ThemeableAttribute」、「ASP.NET のテーマとスキンの概要」の各トピックを参照してください。

使用例

MailDefinition プロパティを使用して、パスワードを変更したユーザーに送信される電子メールメッセージを定義する方法を次のコード例に示します。この例では、送信される電子メールメッセージのテキストを収めた MailFile.txt というファイルがあることを前提にしています。

電子メールメッセージをユーザーに送信するには、アプリケーションの Web.config ファイルで電子メールサーバーを設定する必要があります。詳細については、「方法 : IIS 内で SMTP 仮想サーバーをインストールおよび構成する」を参照してください。

Visual Basic

<%@ page language="VB"%>

<script runat="server">
  Sub Changepassword1_SendingMail(ByVal sender
 As Object, ByVal e As
 MailMessageEventArgs)
        ' Set mail message fields.
        e.Message.Subject = "New user on Web site."
        ' Replace placeholder text in message body with information
 
        '  provided by the user. 
        e.Message.Body.Replace("<%ChangedDate%>",
 DateTime.Now.ToString())
  End Sub
</script>

<html>
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:changepassword id="Changepassword1"
 runat="server" 
          maildefinition-bodyfilename="~/MailFiles/mailfile.txt"
          maildefinition-from="userAdmin@your.site.name.here"
 
          onsendingmail="Changepassword1_SendingMail">
      </asp:changepassword>
    </div>
    </form>
</body>
</html>

<%@ page language="C#"%>

<script runat="server">
  void Changepassword1_SendingMail(object sender, MailMessageEventArgs
 e)
  {
    // Set mail message fields.
    e.Message.Subject = "New user on Web site.";
    // Replace placeholder text in message body with
    // information provided by the user.
    e.Message.Body.Replace("<%ChangedDate%>", (DateTime.Now.ToString())
 );
  }
</script>

<html>
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:changepassword id="Changepassword1" runat="server"
 
        maildefinition-bodyfilename="~/MailFiles/mailfile.txt" 
          maildefinition-from="userAdmin@your.site.name.here" 
          onsendingmail="Changepassword1_SendingMail">
      </asp:changepassword>
    </div>
    </form>
</body>
</html>