CreateUserWizard.OnSendingMail(MailMessageEventArgs) Méthode

Définition

Déclenche l’événement SendingMail avant l’envoi d’un e-mail à un nouvel utilisateur.

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)

Paramètres

e
MailMessageEventArgs

MailMessageEventArgs contenant les données d'événement.

Exemples

L’exemple de code suivant définit un contrôle personnalisé CreateUserWizard qui utilise la OnSendingMail méthode pour modifier le texte de l’e-mail envoyé aux nouveaux utilisateurs. Cet exemple nécessite un fichier texte nommé MailFile.txt qui contient le texte suivant.

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>

Remarques

Utilisez la OnSendingMail méthode pour modifier le message électronique envoyé aux nouveaux utilisateurs. La Message propriété de l’objet MailMessageEventArgs passé en tant que e paramètre contient l’objet MailMessage qui sera envoyé au nouvel utilisateur. Modifiez les propriétés de l’objet MailMessage pour modifier le message électronique.

Email messages sont créés uniquement lorsque la BodyFileName propriété de l’objet MailDefinition spécifié par la MailDefinition propriété pointe vers un nom de fichier valide.

Le déclenchement d'un événement appelle le gestionnaire des événements par l'intermédiaire d'un délégué. Pour plus d’informations, consultez gestion et déclenchement d’événements.

La méthode OnSendingMail permet également aux classes dérivées de gérer l'événement sans y attacher de délégué. Il s'agit de la méthode recommandée pour gérer l'événement dans une classe dérivée.

Notes pour les héritiers

Lors de la OnSendingMail(MailMessageEventArgs) substitution dans une classe dérivée, veillez à appeler la méthode de OnSendingMail(MailMessageEventArgs) la classe de base afin que les délégués inscrits reçoivent l’événement.

S’applique à

Voir aussi