PasswordRecovery.MailDefinition Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ottiene un riferimento a una raccolta di proprietà che definiscono le caratteristiche dei messaggi di posta elettronica utilizzati per inviare password nuove o ripristinate agli utenti.

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

Valore della proprietà

MailDefinition

Riferimento a un MailDefinition che contiene proprietà che definiscono le caratteristiche dei messaggi di posta elettronica usati per inviare agli utenti le password.

Attributi
PersistenceModeAttribute ThemeableAttribute

Esempio

Nell'esempio di codice seguente viene usato l'evento SendingMail per definire il messaggio di posta elettronica della password impostando le proprietà secondarie della proprietà MailDefinition.

<%@ 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>

Commenti

La proprietà MailDefinition restituisce un riferimento a un gruppo di proprietà utilizzate per definire il formato e il contenuto del messaggio di posta elettronica della password inviato agli utenti. Le impostazioni comuni includono la riga dell'oggetto e l'indirizzo di restituzione del mittente. Per un elenco completo delle proprietà, vedere la classe MailDefinition.

Questa proprietà è di sola lettura; Tuttavia, è possibile impostare le proprietà dell'oggetto MailDefinition restituito. È possibile impostare queste proprietà in modo dichiarativo nel formato Property-Subproperty, dove Subproperty rappresenta una proprietà della classe MailDefinition ( ad esempio, MailDefinition-Subject). È anche possibile impostare le proprietà a livello di codice nel form Property.Subproperty ( ad esempio, MailDefinition.Subject).

Questa proprietà non può essere impostata in base a temi o temi del foglio di stile. Per altre informazioni, vedere ThemeableAttribute e ASP.NET Temi e interfacce.

Quando il messaggio di posta elettronica viene creato dall'oggetto MailDefinition, eseguirà le sostituzioni illustrate nella tabella seguente. Il testo di sostituzione non fa distinzione tra maiuscole e minuscole.

Testo di sostituzione Sostituito con
<%UserName%> Nome utente del sito Web dell'utente.
<%password%> Password ripristinata per l'utente.

Se la proprietà IsBodyHtml dell'oggetto MailDefinition è true, il contenuto del messaggio di posta elettronica verrà codificato in formato HTML per evitare vulnerabilità di sicurezza di scripting tra siti per il destinatario del messaggio.

Si applica a

Vedi anche