CreateUserWizard.MailDefinition プロパティ

定義

新規ユーザーに送信される電子メール メッセージの特性を定義するプロパティのコレクションへの参照を取得します。Gets a reference to a collection of properties that define the characteristics of the email message sent to new users.

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; }
member this.MailDefinition : System.Web.UI.WebControls.MailDefinition
Public ReadOnly Property MailDefinition As MailDefinition

プロパティ値

新しいユーザーに送信MailDefinitionされる電子メールメッセージを定義するオブジェクトへの参照。A reference to a MailDefinition object that defines the email message sent to a new user.

属性

例外

From に電子メール アドレスが設定されていません。From is not set to an email address.

次のコード例では、宣言MailDefinition構文とプログラム構文の両方を使用してプロパティのプロパティを設定します。The following code example sets properties of the MailDefinition property by using both declarative and programmatic syntax. このコード例では、次のテキストを含む MailFile という名前のテキストファイルが必要です。This code example requires a text file named MailFile.txt that contains the following text.

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は、新しいユーザーに送信される電子メールメッセージの形式と内容を定義するために使用するプロパティのグループへの参照を返します。The MailDefinition property returns a reference to a group of properties that you use to define the format and content of the email message that is sent to new users. 一般的な設定には、件名と差出人の返信先住所が含まれます。Common settings include the subject line and the sender's return address. プロパティの完全な一覧についてはMailDefinition 、クラスを参照してください。For a complete list of properties, see the MailDefinition class.

プロパティは読み取り専用ですが、返されるMailDefinitionオブジェクトのプロパティを設定できます。 MailDefinitionThe MailDefinition property is read-only; however, you can set the properties of the MailDefinition object it returns. フォームMailDefinition MailDefinition でプロパティMailDefinition-Subjectを宣言によって設定できます。はクラスのプロパティを表します(たとえば、)。Subproperty Property-SubpropertyYou can set the MailDefinition properties declaratively in the form Property-Subproperty, where Subproperty represents a property of the MailDefinition class (for example, MailDefinition-Subject). また、フォームProperty.SubPropertyでプログラムをMailDefinition.Subject使用してプロパティを設定することもできます (例)。You can also set the properties programmatically in the form Property.SubProperty (for example, MailDefinition.Subject).

MailDefinitionがではなくnullBodyが空でもnullでもない場合にのみ、電子メールメッセージが新しいユーザーに送信されます。An email message is sent to new users only if MailDefinition is not null and if Body is not empty or null. この場合、 SendingMailイベントが発生し、電子メールメッセージの送信が試行されます。In that case, the SendingMail event is raised and an attempt is made to send the email message. プロパティFromは、電子メールアドレスに設定する必要があります。The From property must be set to an email address. それ以外のHttpException場合は、例外がスローされます。Otherwise, an HttpException exception is thrown.

MailDefinitionオブジェクトから電子メールメッセージが作成されると、次の表に示す代替が作成されます。When the email message is created from the MailDefinition object, it will make the substitutions listed in the following table.

代替テキストSubstitution text 置換後Replaced with
<%UserName%> 新しく作成されたユーザーアカウントのユーザー名。The user name of the newly created user account.
<%Password%> 新しく作成されたユーザーアカウントのパスワード。The password for the newly created user account.

オブジェクトのプロパティがtrueの場合、メールメッセージの内容は、メッセージ受信者のクロスサイトスクリプティングのセキュリティの脆弱性に対して保護するために、HTML エンコードされます。 IsBodyHtml MailDefinitionIf the IsBodyHtml property of the MailDefinition object is true, the contents of the mail message will be HTML encoded to guard against cross-site scripting security vulnerabilities for the message recipient.

OnSendingMailメソッドを使用して、 MailDefinitionオブジェクトにMailMessageよって作成されたを変更できます。You can use the OnSendingMail method to modify the MailMessage created by the MailDefinition object.

このプロパティは、テーマまたはスタイル シート テーマによって設定することはできません。This property cannot be set by themes or style sheet themes. 詳細についてはThemeableAttribute 、「」および「 ASP.NET theme and スキン」を参照してください。For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

注意

ユーザーが電子メールメッセージを受信または表示することを保証することはできません。It is not possible to guarantee that a user will receive or view an email message. ユーザーが電子メールで通知を受信したことを確認するには、電子メールメッセージに、通知が受信されたことを確認するための確認リンクを提供することを検討してください。To verify that a user has received a notification by email, consider providing a confirmation link in the email message that enables the user to confirm that the notification was received.

適用対象

こちらもご覧ください