PasswordRecovery.OnSendingMail Method
Raises the SendingMail event.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)
Parameters
- e
- Type: System.Web.UI.WebControls.MailMessageEventArgs
A MailMessageEventArgs that contains the event data.
The OnSendingMail method is called after the membership provider has verified that the user is a valid member of the Web site and before the recovered or new password is e-mailed to the user. The default implementation raises the SendingMail event.
Raising an event invokes the event handler through a delegate. For more information, see Events and Delegates.
The OnSendingMail method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.
Notes to InheritorsWhen overriding OnSendingMail in a derived class, be sure to call the base class's OnSendingMail method so that registered delegates receive the event.
The following code example creates a custom PasswordRecovery control that implements the OnSendingMail method to set properties of the MailDefinition property before sending a new password to a Web site user.
<%@ 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"> void Page_Init(object sender, EventArgs e) { PasswordRecoveryOnBeforeSendingEmail passwordRecoveryControl = new PasswordRecoveryOnBeforeSendingEmail(); passwordRecoveryControl.ID = "passwordRecoveryControl"; passwordRecoveryControl.MailDefinition.From = "userAdmin@your.site.name.here"; PlaceHolder1.Controls.Add(passwordRecoveryControl); } </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:placeholder id="PlaceHolder1" runat="server"></asp:placeholder> </form> </body> </html>
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
