CreateUserWizard.MailDefinition Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar en referens till en samling egenskaper som definierar egenskaperna för e-postmeddelandet som skickas till nya användare.
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.MailDefinitionPublic ReadOnly Property MailDefinition As MailDefinitionEgenskapsvärde
En referens till ett MailDefinition objekt som definierar e-postmeddelandet som skickas till en ny användare.
- Attribut
Undantag
From är inte inställt på en e-postadress.
Exempel
I följande kodexempel anges egenskaperna för MailDefinition egenskapen med hjälp av både deklarativ och programmatisk syntax. Det här kodexemplet kräver en textfil med namnet MailFile.txt som innehåller följande 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>
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 nya användare. Vanliga inställningar är ämnesraden och avsändarens returadress. En fullständig lista över egenskaper finns i MailDefinition klassen .
Egenskapen MailDefinition är skrivskyddad. Du kan dock ange egenskaperna för objektet som returneras MailDefinition . Du kan ange MailDefinition egenskaperna deklarativt i formuläret Property-Subproperty, där Subproperty representerar en egenskap för MailDefinition klassen (till exempel MailDefinition-Subject). Du kan också ange egenskaperna programmatiskt i formuläret Property.SubProperty (till exempel MailDefinition.Subject).
Ett e-postmeddelande skickas endast till nya användare om MailDefinition det inte null är och om Body det inte är tomt eller null. I så fall utlöses SendingMail händelsen och ett försök görs att skicka e-postmeddelandet. Egenskapen From måste anges till en e-postadress. Annars utlöses ett HttpException undantag.
När e-postmeddelandet skapas från MailDefinition objektet kommer ersättningarna att visas i följande tabell.
| Ersättningstext | Ersatt med |
|---|---|
<%UserName%> |
Användarnamnet för det nyligen skapade användarkontot. |
<%Password%> |
Lösenordet för det nyligen skapade användarkontot. |
IsBodyHtml Om egenskapen MailDefinition för objektet är truekodas innehållet i e-postmeddelandet med HTML för att skydda mot säkerhetsrisker för skript mellan webbplatser för meddelandemottagaren.
Du kan använda OnSendingMail metoden för att ändra den MailMessage som skapats av MailDefinition objektet.
Den här egenskapen kan inte anges med teman eller formatmallsteman. Mer information finns i ThemeableAttribute and ASP.NET Themes and Skins.
Note
Det går inte att garantera att en användare får eller visar ett e-postmeddelande. Om du vill kontrollera att en användare har fått ett meddelande via e-post kan du överväga att tillhandahålla en bekräftelselänk i e-postmeddelandet som gör det möjligt för användaren att bekräfta att meddelandet har tagits emot.
