Freigeben über

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-Nachricht 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 an einen neuen Benutzer gesendete E-Mail-Nachricht definiert.

Attribute
PersistenceModeAttribute ThemeableAttribute

Ausnahmen

HttpException

Die eigenschaft From ist nicht auf eine E-Mail-Adresse festgelegt.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie die eigenschaft MailDefinition verwenden, um eine E-Mail-Nachricht zu 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 zu sendenden Text der 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 How to: Install and Configure SMTP Virtual Servers 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 wurde, nachdem sie ihr Kennwort geändert haben. Allgemeine Einstellungen umfassen die Betreffzeile und die Absenderadresse des Absenders. Eine vollständige Liste der Eigenschaften finden Sie unter MailDefinition.

Die MailDefinition-Eigenschaft ist schreibgeschützt; Sie können jedoch die Eigenschaften des zurückgegebenen MailDefinition Objekts festlegen. Sie können diese Eigenschaften im Formular Eigenschaft-Untereigenschaftfestlegen, wobei Untereigenschaft eine Eigenschaft der MailDefinition Klasse darstellt (z. B. MailDefinition-Subject). Sie können die Eigenschaften auch programmgesteuert im Formular Property.Subproperty- (z. B.MailDefinition.Subject) festlegen.

Eine E-Mail-Nachricht wird nur gesendet, wenn der Benutzer über eine E-Mail-Adresse verfügt, die beim Mitgliedschaftsanbieter registriert ist und die eigenschaft BodyFileName der MailDefinition auf eine gültige Datei verweist. Wenn die eigenschaft BodyFileName festgelegt ist, muss die eigenschaft From 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 Ersetzungen in der folgenden Tabelle dargestellt. Bei dem Ersetzungstext wird die Groß-/Kleinschreibung nicht beachtet.

Ersetzungstext Ersetzt durch
<%UserName%> Der Benutzername der Website des Benutzers.
<%Kennwort%> Das neue Kennwort für den Benutzer.

Wenn die IsBodyHtml Eigenschaft des MailDefinition-Objekts trueist, wird der Inhalt der E-Mail-Nachricht HTML-codiert, um vor websiteübergreifenden Skriptingsicherheitsrisiken für den Nachrichtenempfänger zu schützen.

Sie können das SendingMail-Ereignis verwenden, um das MailMessage Objekt zu ändern, das vom MailDefinition-Objekt erstellt wird.

Wichtig

Das Senden von Benutzernamen oder Kennwörtern in E-Mails ist eine potenzielle Sicherheitsgefahr. 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 in Sichern von Anmeldesteuerelementenbeschriebenen Gegenmaßnahmen.

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