CreateUserWizard.OnSendingMail(MailMessageEventArgs) Metodo

  • Riferimento

Definizione

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

Genera l'evento SendingMail prima dell'invio di un messaggio di posta elettronica al nuovo utente.

protected:
 virtual void OnSendingMail(System::Web::UI::WebControls::MailMessageEventArgs ^ e);
protected virtual void OnSendingMail (System.Web.UI.WebControls.MailMessageEventArgs e);
abstract member OnSendingMail : System.Web.UI.WebControls.MailMessageEventArgs -> unit
override this.OnSendingMail : System.Web.UI.WebControls.MailMessageEventArgs -> unit
Protected Overridable Sub OnSendingMail (e As MailMessageEventArgs)

Parametri

e
MailMessageEventArgs

Oggetto MailMessageEventArgs che contiene i dati dell'evento.

Esempio

Nell'esempio di codice seguente viene definito un controllo personalizzato CreateUserWizard che usa il OnSendingMail metodo per modificare il testo del messaggio di posta elettronica inviato ai nuovi utenti. Questo esempio 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#"%>
<%@ Import namespace="Samples.AspNet.CS.Controls" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
private void Page_Load(object sender, EventArgs e) {    
    Placeholder1.Controls.Add(new CustomCreateUserWizard());
}
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>CreateUserWizard.OnSendingMail sample</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:placeholder id="Placeholder1" runat="server" >
      </asp:placeholder>
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB"%>
<%@ Import namespace="Samples.AspNet.VB.Controls" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
    Dim createUser As New CustomCreateUserWizard
    Placeholder1.Controls.Add(createUser)
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>CreateUserWizard.OnSendingMail sample</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:placeholder id="Placeholder1" runat="server" >
      </asp:placeholder>
    </div>
    </form>
</body>
</html>

Commenti

Usare il OnSendingMail metodo per modificare il messaggio di posta elettronica inviato ai nuovi utenti. La Message proprietà dell'oggetto MailMessageEventArgs passato come e parametro contiene l'oggetto MailMessage che verrà inviato al nuovo utente. Modificare le proprietà dell'oggetto MailMessage per modificare il messaggio di posta elettronica.

I messaggi di posta elettronica vengono creati solo quando la BodyFileName proprietà dell'oggetto MailDefinition specificato dalla MailDefinition proprietà punta a un nome di file valido.

Quando viene generato un evento, il gestore dell'evento viene richiamato tramite un delegato. Per altre informazioni, vedere la gestione e generazione di eventi.

Il metodo OnSendingMail consente inoltre alle classi derivate di gestire l'evento senza associare un delegato. È la tecnica consigliata per la gestione dell'evento in una classe derivata.

Note per gli eredi

Quando si esegue l'override OnSendingMail(MailMessageEventArgs) in una classe derivata, assicurarsi di chiamare il metodo della OnSendingMail(MailMessageEventArgs) classe base in modo che i delegati registrati ricevano l'evento.

Si applica a

Vedi anche