ChangePassword.MailDefinition Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá odkaz na kolekci vlastností, které definují e-mailovou zprávu, která je odeslána uživatelům po změně hesla.
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
Hodnota vlastnosti
Odkaz na MailDefinition objekt, který definuje e-mailovou zprávu odeslanou novému uživateli.
- Atributy
Výjimky
Vlastnost From není nastavená na e-mailovou adresu.
Příklady
Následující příklad kódu ukazuje, jak pomocí MailDefinition vlastnosti definovat e-mailovou zprávu, která se odešle uživatelům, kteří změní svá hesla. Předpokládá se, že existuje soubor s názvem MailFile.txt
, který obsahuje text e-mailové zprávy, která se má odeslat.
Pokud chcete uživatelům posílat e-mailové zprávy, musíte nakonfigurovat e-mailový server v souboru Web.config pro vaši aplikaci. Další informace naleznete v tématu Postupy: Instalace a konfigurace virtuálních serverů SMTP ve službě 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>
Poznámky
Vlastnost MailDefinition vrátí odkaz na skupinu vlastností, které slouží k definování formátu a obsahu e-mailové zprávy odeslané uživatelům po změně hesla. Mezi běžná nastavení patří řádek předmětu a zpáteční adresa odesílatele. Úplný seznam vlastností najdete v tématu MailDefinition.
Vlastnost MailDefinition je jen pro čtení, ale můžete nastavit vlastnosti objektu, který MailDefinition vrací. Tyto vlastnosti můžete nastavit vdílčím umístěnívlastnosti-
formuláře, kde subproperty představuje vlastnost MailDefinition třídy (například MailDefinition-Subject
). Vlastnosti můžete také nastavit programově ve formátuPodpropertyvlastnosti.
(napříkladMailDefinition.Subject
).
E-mailová zpráva se odešle pouze v případě, že má uživatel e-mailovou adresu zaregistrovanou u poskytovatele členství a pokud BodyFileName vlastnost MailDefinition odkazuje na platný soubor. BodyFileName Pokud je vlastnost nastavená, From musí být vlastnost nastavená na e-mailovou adresu, jinak dojde k výjimceHttpException.
Pokud je e-mailová zpráva vytvořená z objektu MailDefinition , provede nahrazení uvedené v následující tabulce. V náhradním textu se nerozlišují malá a velká písmena.
Náhradní text | Nahrazeno za |
---|---|
<%UserName %> |
Uživatelské jméno webu uživatele. |
<%Password%> | Nové heslo pro uživatele |
IsBodyHtml Pokud je true
vlastnost objektu MailDefinition , obsah e-mailové zprávy bude zakódován ve formátu HTML, aby bylo možné chránit před ohroženími zabezpečení pro příjemce zprávy skriptováním mezi weby.
Událost můžete použít SendingMail k úpravě objektu MailMessage vytvořeného objektem MailDefinition .
Důležité
Odesílání názvů uživatelských účtů nebo hesel v e-mailu je potenciální bezpečnostní hrozbou. E-mailové zprávy se obvykle odesílají ve formátu prostého textu a mohou být čteny speciálními síťovými aplikacemi pro "čichání". Pokud chcete zlepšit zabezpečení, použijte omezení rizik popsaná v tématu Zabezpečení přihlašovacích ovládacích prvků.
Tuto vlastnost nelze nastavit pomocí motivů nebo šablon stylů. Další informace najdete v tématu ThemeableAttribute a ASP.NET Motivy a skiny.
Platí pro
Viz také
- Přehled ovládacích prvků přihlášení ASP.NET
- Přizpůsobení vzhledu a chování ovládacích prvků přihlášení ASP.NET
- šablony ovládacích prvků webového serveru ASP.NET
- Postupy: Zobrazení různých informací anonymním a přihlášeným uživatelům
- Karta Zabezpečení nástroje správa webu
- Zabezpečení ovládacích prvků přihlášení
- Základní postupy zabezpečení pro webové aplikace
- Zabezpečení členství
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro