CreateUserWizard.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 del messaggio di posta elettronica inviato ai nuovi 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 oggetto che definisce il messaggio di posta elettronica inviato a un nuovo utente.

Attributi
PersistenceModeAttribute ThemeableAttribute

Eccezioni

HttpException

La proprietà From non è impostata su un indirizzo di posta elettronica.

Esempio

Nell'esempio MailDefinition di codice seguente vengono impostate le proprietà della proprietà usando la sintassi dichiarativa e programmatica. Questo esempio di codice richiede un file di testo denominato MailFile.txt contenente il testo seguente.

Your account was set up on our Web site with the following:

    Username:   <%UserName%>

To reset your password, you must answer the following question:

    Password Question: <%PasswordQuestion%>
    Password Answer:   <%PasswordAnswer%>

Thank you for creating an account with our Web site.

<%@ 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 Createuserwizard1_SendingMail(object sender, MailMessageEventArgs e)
  {
    // Set MailMessage fields.
    e.Message.IsBodyHtml = false;
    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("<%PasswordQuestion%>", Createuserwizard1.Question);
    e.Message.Body = e.Message.Body.Replace("<%PasswordAnswer%>",   Createuserwizard1.Answer);  
}
  
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>
      CreateUserWizard.MailDefinition sample</title>
  </head>
  <body>
    <form id="form1" runat="server">
      <div>
        <asp:createuserwizard id="Createuserwizard1" runat="server" 
          maildefinition-bodyfilename="MailFile.txt"
          maildefinition-from="userAdmin@your.site.name.here" 
          onsendingmail="Createuserwizard1_SendingMail">
        </asp:createuserwizard>
      </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 Createuserwizard1_SendingMail(ByVal sender As Object, ByVal e As MailMessageEventArgs)
    ' Set MailMessage fields.
    e.Message.IsBodyHtml = False
    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("<%PasswordQuestion%>", Createuserwizard1.Question)
    e.Message.Body = e.Message.Body.Replace("<%PasswordAnswer%>",   Createuserwizard1.Answer)
  End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>
      CreateUserWizard.MailDefinition sample</title>
  </head>
  <body>
    <form id="form1" runat="server">
      <div>
        <asp:createuserwizard id="Createuserwizard1" runat="server" 
          maildefinition-bodyfilename="MailFile.txt"
          maildefinition-from="userAdmin@your.site.name.here" 
          onsendingmail="Createuserwizard1_SendingMail">
        </asp:createuserwizard>
      </div>
    </form>
  </body>
</html>

Commenti

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

La MailDefinition proprietà è di sola lettura. È tuttavia possibile impostare le proprietà dell'oggetto MailDefinition restituito. È possibile impostare le MailDefinition proprietà dichiarative nel formato Property-Subproperty, dove Subproperty rappresenta una proprietà della MailDefinition classe , ad esempio MailDefinition-Subject. È anche possibile impostare le proprietà a livello di codice nel modulo Property.SubProperty , ad esempio MailDefinition.Subject.

Un messaggio di posta elettronica viene inviato ai nuovi utenti solo se MailDefinition non null è e se Body non è vuoto o null. In tal caso, l'evento SendingMail viene generato e viene eseguito un tentativo di invio del messaggio di posta elettronica. La From proprietà deve essere impostata su un indirizzo di posta elettronica. In caso contrario, viene generata un'eccezione HttpException .

Quando il messaggio di posta elettronica viene creato dall'oggetto MailDefinition , eseguirà le sostituzioni elencate nella tabella seguente.

Testo di sostituzione Sostituito con
<%UserName%> Nome utente dell'account utente appena creato.
<%Password%> Password per l'account utente appena creato.

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

È possibile usare il OnSendingMail metodo per modificare l'oggetto MailMessage creato dall'oggetto MailDefinition .

Questa proprietà non può essere impostata da temi oppure temi di fogli di stile. Per altre informazioni, vedere ThemeableAttribute e ASP.NET Temi e skin.

Nota

Non è possibile garantire che un utente riceva o visualizzi un messaggio di posta elettronica. Per verificare che un utente abbia ricevuto una notifica tramite posta elettronica, è consigliabile specificare un collegamento di conferma nel messaggio di posta elettronica che consente all'utente di confermare che la notifica è stata ricevuta.

Si applica a

Vedi anche