ChangePassword.MailDefinition Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft einen Verweis auf eine Auflistung von Eigenschaften ab, die die E-Mail definieren, die an Benutzer gesendet wird, nachdem sie ihr Kennwort geändert haben.
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
Eigenschaftswert
Ein Verweis auf ein MailDefinition Objekt, das die E-Mail-Nachricht definiert, die an einen neuen Benutzer gesendet wird.
- Attribute
Ausnahmen
Die From-Eigenschaft wird nicht auf eine bestimmte E-Mail-Adresse festgelegt.
Beispiele
Im folgenden Codebeispiel wird gezeigt, wie Sie mithilfe der MailDefinition -Eigenschaft eine E-Mail-Nachricht definieren, die an Benutzer gesendet wird, die ihre Kennwörter ändern. Es wird davon ausgegangen, dass es eine Datei namens MailFile.txt
gibt, die den Text der zu sendenden E-Mail-Nachricht enthält.
Um E-Mail-Nachrichten an Benutzer senden zu können, müssen Sie einen E-Mail-Server in der Web.config-Datei für Ihre Anwendung konfigurieren. Weitere Informationen finden Sie unter Vorgehensweise: Installieren und Konfigurieren virtueller SMTP-Server 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>
Hinweise
Die MailDefinition -Eigenschaft gibt einen Verweis auf eine Gruppe von Eigenschaften zurück, die Sie verwenden, um das Format und den Inhalt der E-Mail-Nachricht zu definieren, die an Benutzer gesendet wird, nachdem sie ihr Kennwort geändert haben. Zu den allgemeinen Einstellungen gehören die Betreffzeile und die Absender-Rückgabeadresse. Eine vollständige Liste der Eigenschaften finden Sie unter MailDefinition.
Die MailDefinition Eigenschaft ist schreibgeschützt; Sie können jedoch festlegen, die Eigenschaften der MailDefinition -Objekt wird zurückgegeben. Sie können diese Eigenschaften in derUntereigenschaft der Formulareigenschaft-
festlegen, wobei die Untereigenschaft eine Eigenschaft der MailDefinition -Klasse darstellt (z. BMailDefinition-Subject
. ). Sie können die Eigenschaften auch programmgesteuert im FormatEigenschaftenuntereigenschaft.
festlegen (z. BMailDefinition.Subject
.).
Eine E-Mail-Nachricht wird nur gesendet, wenn der Benutzer eine E-Mail-Adresse beim Mitgliedschaftsanbieter registriert hat und wenn die BodyFileName Eigenschaft der MailDefinition Eigenschaft auf eine gültige Datei verweist. Wenn die BodyFileName -Eigenschaft festgelegt ist, muss die From -Eigenschaft auf eine E-Mail-Adresse festgelegt werden. Andernfalls wird eine HttpException Ausnahme ausgelöst.
Wenn die E-Mail-Nachricht aus dem MailDefinition -Objekt erstellt wird, werden die in der folgenden Tabelle aufgeführten Ersetzungen vorgenommen. Beim Ersetzungstext wird die Groß-/Kleinschreibung nicht beachtet.
Ersetzungstext | Ersetzt durch |
---|---|
<%UserName %> |
Der Websitebenutzername des Benutzers. |
<%Kennwort%> | Das neue Kennwort für den Benutzer. |
Wenn die IsBodyHtml -Eigenschaft des MailDefinition -Objekts lautet true
, wird der Inhalt der E-Mail-Nachricht HTML-codiert, um sicherheitsrelevante Sicherheitsrisiken für den Nachrichtenempfänger bei websiteübergreifendem Skripting zu schützen.
Sie können das SendingMail -Ereignis verwenden, um das MailMessage Objekt zu ändern, das MailDefinition vom Objekt erstellt wird.
Wichtig
Das Senden von Benutzernamen oder Kennwörtern per E-Mail stellt eine potenzielle Sicherheitsbedrohung dar. E-Mail-Nachrichten werden in der Regel als Nur-Text gesendet und können von speziellen Netzwerkanwendungen gelesen werden. Um die Sicherheit zu verbessern, verwenden Sie die Unter Sichern von Anmeldesteuerelementen beschriebenen Entschärfungen.
Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET-Designs und Skins.
Gilt für:
Weitere Informationen
- Übersicht über ASP.NET Anmeldesteuerelemente
- Anpassen der Darstellung und des Verhaltens der ASP.NET Anmeldesteuerelemente
- Vorlagen für ASP.NET Webserversteuerelemente
- Vorgehensweise: Anzeigen unterschiedlicher Informationen für anonyme und angemeldete Benutzer
- Registerkarte "Sicherheit" des Websiteverwaltungstools
- Schützen von Anmeldesteuerelementen
- Grundlegende Sicherheitsmaßnahmen für Webanwendungen
- Sichern der Mitgliedschaft
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für