Freigeben über

PasswordRecovery.MailDefinition Eigenschaft

  • Referenz

Definition

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

Ruft einen Verweis auf eine Auflistung von Eigenschaften ab, die die Merkmale von E-Mail-Nachrichten definieren, die zum Senden neuer oder wiederhergestellter Kennwörter an Benutzer verwendet werden.

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 eine MailDefinition, die Eigenschaften enthält, die die Merkmale von E-Mail-Nachrichten definieren, mit denen Benutzer ihre Kennwörter gesendet werden.

Attribute
PersistenceModeAttribute ThemeableAttribute

Beispiele

Im folgenden Codebeispiel wird das SendingMail-Ereignis verwendet, um die Kennwort-E-Mail-Nachricht zu definieren, indem Untereigenschaften der eigenschaft MailDefinition festgelegt werden.

<%@ 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 PasswordRecovery1_SendingMail(object sender, MailMessageEventArgs e)
  {
    e.Message.IsBodyHtml = false;
    e.Message.Subject = "New password on Web site.";
  }
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:passwordrecovery 
         id="PasswordRecovery1" 
         runat="server"
         maildefinition-from="userAdmin@your.site.name.here"
         onsendingmail="PasswordRecovery1_SendingMail">
      </asp:passwordrecovery>
    </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 PasswordRecovery1_SendingMail(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.MailMessageEventArgs)

    e.Message.IsBodyHtml = False
    e.Message.Subject = "New password on Web site."
    
  End Sub
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:passwordrecovery
         id="PasswordRecovery1" 
         runat="server" 
         maildefinition-from="userAdmin@your.site.name.here"
         onsendingmail="PasswordRecovery1_SendingMail">
      </asp:passwordrecovery>
    </form>
  </body>
</html>

Hinweise

Die eigenschaft MailDefinition gibt einen Verweis auf eine Gruppe von Eigenschaften zurück, die Sie zum Definieren von Format und Inhalt der an Benutzer gesendeten Kennwort-E-Mail-Nachricht verwenden. Allgemeine Einstellungen umfassen die Betreffzeile und die Absenderadresse des Absenders. Eine vollständige Liste der Eigenschaften finden Sie in der MailDefinition Klasse.

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

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET Designs und Skins.

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

Gilt für:

Weitere Informationen