共用方式為

ChangePassword.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 的檔案，其中包含要傳送的電子郵件訊息文字。

若要能夠將電子郵件訊息傳送給使用者，您必須在應用程式的 Web.config 檔案中設定電子郵件伺服器。 如需詳細資訊，請參閱 How to： Install and Configure SMTP Virtual Servers in IIS 6.0。

<%@ 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 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 = e.Message.Body.Replace("<%ChangedDate%>", (DateTime.Now.ToString()) );
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<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="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 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 = e.Message.Body.Replace("<%ChangedDate%>", DateTime.Now.ToString())
  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<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>

備註

MailDefinition 屬性會傳回一組屬性的參考，這些屬性可用來定義在使用者變更密碼之後傳送給使用者的電子郵件訊息格式和內容。 常見的設定包括主旨行和寄件者的傳回位址。 如需屬性的完整清單，請參閱 MailDefinition。

MailDefinition 屬性是唯讀的;不過，您可以設定所傳回 MailDefinition 對象的屬性。 您可以在子屬性的表單 屬性設定這些屬性，其中 子屬性 代表 類別的屬性（例如，）。 您也可以以程式設計方式在屬性 屬性.Subproperty 窗體中設定屬性（例如，MailDefinition.Subject）。

只有當使用者具有向成員資格提供者註冊的電子郵件位址，且 MailDefinition 屬性的 BodyFileName 屬性指向有效的檔案時，才會傳送電子郵件訊息。 如果已設定 BodyFileName 屬性，From 屬性必須設定為電子郵件位址;否則，會擲回 HttpException 例外狀況。

如果電子郵件訊息是從 MailDefinition 物件建立的，則會進行下表所示的替代專案。 替代文字不區分大小寫。

替換文字 取代為
<%UserName%> 用戶的網站用戶名稱。
<%密碼%> 使用者的新密碼。

如果 MailDefinition 物件的 IsBodyHtml 屬性是 true，郵件訊息的內容會經過 HTML 編碼，以防止郵件收件者的跨網站腳本安全性弱點。

您可以使用 SendingMail 事件來修改 MailDefinition 物件所建立的 MailMessage 物件。

重要

在電子郵件中傳送用戶帳戶名稱或密碼是潛在的安全性威脅。 電子郵件訊息通常會以純文本傳送，而且可由特殊網路「探查」應用程式讀取。 若要改善安全性，請使用 保護登入控件中所述的風險降低措施。

這個屬性不能由主題或樣式表單主題設定。 如需詳細資訊，請參閱 ThemeableAttribute 和 ASP.NET 主題和面板。

適用於

另請參閱