CreateUserWizard.MailDefinition 属性

  • 参考

定义

命名空间:
System.Web.UI.WebControls
程序集:
System.Web.dll

获取一个对属性集合的引用，这些属性用于定义发送给新用户的电子邮件的特征。

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 。 可以在 窗体 Property-Subproperty中以声明方式设置MailDefinition属性，其中Subproperty表示MailDefinition类 (的属性， MailDefinition-Subject 例如，) 。 还可以以编程方式在窗体 Property.SubProperty 中 (设置属性， MailDefinition.Subject 例如，) 。

仅当 不是 nullBody 且 不为空或 null时MailDefinition，才会向新用户发送电子邮件。 在这种情况下，将 SendingMail 引发 事件并尝试发送电子邮件。 属性 From 必须设置为电子邮件地址。 否则， HttpException 将引发异常。

从 MailDefinition 对象创建电子邮件时，它将进行下表中列出的替换。

替换文本 替换为
<%UserName%> 新创建的用户帐户的用户名。
<%Password%> 新创建的用户帐户的密码。

IsBodyHtml如果 对象的 属性MailDefinition为 true，则邮件内容将进行 HTML 编码，以防止邮件收件人的跨站点脚本安全漏洞。

可以使用 OnSendingMail 方法修改 MailMessage 由 MailDefinition 对象创建的 。

无法通过主题或样式表主题设置此属性。 有关详细信息，请参阅 ThemeableAttribute 和 ASP.NET 主题和外观。

注意

无法保证用户会收到或查看电子邮件。 若要验证用户是否已通过电子邮件收到通知，请考虑在电子邮件中提供确认链接，使用户能够确认已收到通知。

适用于

另请参阅