PasswordRecovery.MailDefinition Eigenschaft

  • Referenz

Definition

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

Ruft einen Verweis auf eine Auflistung von Eigenschaften auf, die die Merkmale von E-Mail definieren, in denen neue oder wiederhergestellte Kennwörter an Benutzer gesendet 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 ein MailDefinition , der Eigenschaften enthält, die die Merkmale von E-Mail-Nachrichten definieren, die zum Senden von Kennwörtern für Benutzer verwendet werden.

Attribute
PersistenceModeAttribute ThemeableAttribute

Beispiele

Im folgenden Codebeispiel wird das SendingMail -Ereignis verwendet, um die Kennwort-E-Mail-Nachricht zu definieren, indem Untereigenschaften der MailDefinition -Eigenschaft 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 MailDefinition -Eigenschaft 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. Häufige Einstellungen sind die Betreffzeile und die Absender-Rückgabeadresse. 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 festlegen, in der Form Property-Subproperty, wobei Subproperty stellt eine Eigenschaft von der MailDefinition Klasse (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 in der folgenden Tabelle dargestellten Ersetzungen vorgenommen. Beim Ersetzungstext wird die Groß-/Kleinschreibung nicht beachtet.

Ersetzungstext Ersetzt durch
<%UserName%> Der Websitebenutzername des Benutzers.
<%Password%> Das wiederhergestellte 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 beim Websiteskripting für den Nachrichtenempfänger zu schützen.

Gilt für:

Weitere Informationen