PasswordRecovery.OnSendingMail Method (MailMessageEventArgs)

 

Raises the SendingMail event.

Namespace:   System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

Protected Overridable Sub OnSendingMail (
	e As MailMessageEventArgs
)

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 NIB: 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 Inheritors:

When 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="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_Init(ByVal sender As Object, ByVal e As EventArgs)

    Dim passwordRecoveryControl As New PasswordRecoveryOnBeforeSendingEmail

    passwordRecoveryControl.ID = "passwordRecoveryControl"
    passwordRecoveryControl.MailDefinition.From = "userAdmin@your.site.name.here"
    PlaceHolder1.Controls.Add(passwordRecoveryControl)

  End Sub

</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>

.NET Framework
Available since 2.0
Return to top
Show: