CreateUserWizard.MailDefinition プロパティ

リファレンス

定義

名前空間:: System.Web.UI.WebControls

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

新規ユーザーに送信される電子メールメッセージの特性を定義するプロパティのコレクションへの参照を取得します。

public:
 property System::Web::UI::WebControls::MailDefinition ^ MailDefinition { System::Web::UI::WebControls::MailDefinition ^ get(); };

[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
[System.Web.UI.Themeable(false)]
public System.Web.UI.WebControls.MailDefinition MailDefinition { get; }

[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
[<System.Web.UI.Themeable(false)>]
member this.MailDefinition : System.Web.UI.WebControls.MailDefinition

Public ReadOnly Property MailDefinition As MailDefinition

プロパティ値

MailDefinition

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

属性: PersistenceModeAttribute ThemeableAttribute

例外

HttpException

From に電子メールアドレスが設定されていません。

例

次のコード例では、宣言型構文とプログラム構文の両方を MailDefinition 使用して、プロパティのプロパティを設定します。このコード例では、次のテキストを含む MailFile.txt という名前のテキストファイルが必要です。

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#"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  void Createuserwizard1_SendingMail(object sender, MailMessageEventArgs e)
  {
    // Set MailMessage fields.
    e.Message.IsBodyHtml = false;
    e.Message.Subject = "New user on Web site.";
    // Replace placeholder text in message body with information 
    // provided by the user.
    e.Message.Body = e.Message.Body.Replace("<%PasswordQuestion%>", Createuserwizard1.Question);
    e.Message.Body = e.Message.Body.Replace("<%PasswordAnswer%>",   Createuserwizard1.Answer);  
}
  
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>
      CreateUserWizard.MailDefinition sample</title>
  </head>
  <body>
    <form id="form1" runat="server">
      <div>
        <asp:createuserwizard id="Createuserwizard1" runat="server" 
          maildefinition-bodyfilename="MailFile.txt"
          maildefinition-from="userAdmin@your.site.name.here" 
          onsendingmail="Createuserwizard1_SendingMail">
        </asp:createuserwizard>
      </div>
    </form>
  </body>
</html>

<%@ page language="VB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  Sub Createuserwizard1_SendingMail(ByVal sender As Object, ByVal e As MailMessageEventArgs)
    ' Set MailMessage fields.
    e.Message.IsBodyHtml = False
    e.Message.Subject = "New user on Web site."
    ' Replace placeholder text in message body with information 
    ' provided by the user.
   e.Message.Body = e.Message.Body.Replace("<%PasswordQuestion%>", Createuserwizard1.Question)
    e.Message.Body = e.Message.Body.Replace("<%PasswordAnswer%>",   Createuserwizard1.Answer)
  End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>
      CreateUserWizard.MailDefinition sample</title>
  </head>
  <body>
    <form id="form1" runat="server">
      <div>
        <asp:createuserwizard id="Createuserwizard1" runat="server" 
          maildefinition-bodyfilename="MailFile.txt"
          maildefinition-from="userAdmin@your.site.name.here" 
          onsendingmail="Createuserwizard1_SendingMail">
        </asp:createuserwizard>
      </div>
    </form>
  </body>
</html>

注釈

プロパティは MailDefinition 、新しいユーザーに送信される電子メールメッセージの形式と内容を定義するために使用するプロパティのグループへの参照を返します。一般的な設定には、件名行と送信者の差出人住所が含まれます。プロパティの完全な一覧については、クラスを MailDefinition 参照してください。

プロパティは MailDefinition 読み取り専用です。ただし、返されるオブジェクトのプロパティを MailDefinition 設定できます。プロパティは MailDefinition 、という形式 Property-Subpropertyで宣言的に設定できます。ここで Subproperty 、はクラスの MailDefinition プロパティを表します (例: MailDefinition-Subject)。フォーム Property.SubProperty でプログラムでプロパティを設定することもできます (例: MailDefinition.Subject)。

がでない場合、または nullが空でないnull場合MailDefinitionにのみ、Body新しいユーザーに電子メールメッセージが送信されます。その場合、 SendingMail イベントが発生し、電子メールメッセージの送信が試行されます。プロパティは From 、電子メールアドレスに設定する必要があります。それ以外の場合は、 HttpException 例外がスローされます。

オブジェクトから電子メールメッセージを MailDefinition 作成すると、次の表に示す置換が行われます。

置換テキスト	新しいモジュール
`<%UserName%>`	新しく作成されたユーザーアカウントのユーザー名。
`<%Password%>`	新しく作成されたユーザーアカウントのパスワード。

オブジェクトの IsBodyHtml MailDefinition プロパティがの場合、 trueメールメッセージの内容は HTML エンコードされ、メッセージ受信者のクロスサイトスクリプティングセキュリティの脆弱性から保護されます。

メソッドをOnSendingMail使用して、オブジェクトによって作成されたをMailMessage MailDefinition変更できます。

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

注意

ユーザーが電子メールメッセージを受信または表示することを保証することはできません。ユーザーが電子メールで通知を受信したことを確認するには、ユーザーが通知を受信したことを確認できる確認リンクを電子メールメッセージに指定することを検討してください。

適用対象

次の方法で共有

CreateUserWizard.MailDefinition プロパティ

定義

プロパティ値

例外

例

注釈

適用対象

こちらもご覧ください

その他のリソース