CreateUserWizard.OnSendingMail(MailMessageEventArgs) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
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 l’e-mail.
Les messages électroniques 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 la classe de OnSendingMail(MailMessageEventArgs) base afin que les délégués inscrits reçoivent l’événement.