CreateUserWizard.MailDefinition プロパティ

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 オブジェクトへの参照。

属性

PersistenceModeAttribute ThemeableAttribute

例外

例

次のコード例では、宣言構文とプログラム構文の両方を使用して、 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) でプロパティをプログラムで設定することもできます。

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

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

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

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

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

こちらもご覧ください

• MailDefinition
• MailMessage
• OnSendingMail(MailMessageEventArgs)
• ログイン ASP.NET コントロール