PasswordRecovery.MailDefinition Proprietà

Riferimento

Definizione

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

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

MailDefinition
Panoramica dei controlli di accesso di ASP.NET

Condividi tramite