ChangePassword.MailDefinition Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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

MailDefinition

Ein Verweis auf ein MailDefinition Objekt, das die E-Mail-Nachricht definiert, die an einen neuen Benutzer gesendet wird.

Attribute
PersistenceModeAttribute ThemeableAttribute

Ausnahmen

HttpException

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. Email 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