ChangePassword.MailDefinition Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Hämtar en referens till en samling egenskaper som definierar e-postmeddelandet som skickas till användare när de har ändrat sitt lösenord.

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

Egenskapsvärde

MailDefinition

En referens till ett MailDefinition objekt som definierar e-postmeddelandet som skickas till en ny användare.

Attribut
PersistenceModeAttribute ThemeableAttribute

Undantag

HttpException

Egenskapen From är inte inställd på en e-postadress.

Exempel

Följande kodexempel visar hur du använder MailDefinition egenskapen för att definiera ett e-postmeddelande som skickas till användare som ändrar sina lösenord. Det förutsätter att det finns en fil med namnet MailFile.txt som innehåller texten i e-postmeddelandet som ska skickas.

För att kunna skicka e-postmeddelanden till användare måste du konfigurera en e-postserver i Web.config-filen för ditt program. Mer information finns i Installera och konfigurera virtuella SMTP-servrar i 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>

Kommentarer

Egenskapen MailDefinition returnerar en referens till en grupp egenskaper som du använder för att definiera formatet och innehållet i e-postmeddelandet som skickas till användare när de har ändrat sitt lösenord. Vanliga inställningar är ämnesraden och avsändarens returadress. En fullständig lista över egenskaper finns i MailDefinition.

Egenskapen MailDefinition är skrivskyddad. Du kan dock ange egenskaperna för objektet som returneras MailDefinition . Du kan ange dessa egenskaper iunderegenskaperna för -, där underegenskaper representerar en egenskap för MailDefinition klassen (till exempel MailDefinition-Subject). Du kan också ange egenskaperna programmatiskt i formuläretEgenskapsunderegenskaper. (till exempelMailDefinition.Subject).

Ett e-postmeddelande skickas endast om användaren har en e-postadress registrerad hos medlemskapsprovidern och om BodyFileName egenskapens MailDefinition egenskap pekar på en giltig fil. Om egenskapen BodyFileName har angetts From måste egenskapen anges till en e-postadress. Annars genereras ett HttpException undantag.

Om e-postmeddelandet skapas från MailDefinition objektet kommer ersättningarna att visas i följande tabell. Ersättningstexten är skiftlägeskänslig.

Ersättningstext Ersatt med
< UserName%%> Användarens webbplatsanvändarnamn.
<%Lösenord%> Det nya lösenordet för användaren.

IsBodyHtml Om egenskapen MailDefinition för objektet är true, kommer innehållet i e-postmeddelandet att HTML-kodas för att skydda mot säkerhetsrisker för skript mellan webbplatser för meddelandemottagaren.

Du kan använda SendingMail händelsen för att ändra objektet MailMessage som skapas av MailDefinition objektet.

Important

Att skicka användarnamn eller lösenord i e-post är ett potentiellt säkerhetshot. E-postmeddelanden skickas vanligtvis i oformaterad text och kan läsas av särskilda nätverksprogram för "sniffning". Du kan förbättra säkerheten genom att använda de åtgärder som beskrivs i Skydda inloggningskontroller.

Den här egenskapen kan inte anges med teman eller formatmallsteman. Mer information finns i ThemeableAttribute and ASP.NET Themes and Skins.

Gäller för

Se även