Compartilhar via


CreateUserWizard.OnSendingMail(MailMessageEventArgs) Método

Definição

Aciona o evento SendingMail antes de uma mensagem de email ser enviada a um novo usuário.

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)

Parâmetros

e
MailMessageEventArgs

Um MailMessageEventArgs que contém os dados de evento.

Exemplos

O exemplo de código a seguir define um controle personalizado CreateUserWizard que usa o OnSendingMail método para modificar o texto do email enviado a novos usuários. Este exemplo requer um arquivo de texto chamado MailFile.txt que contém o texto a seguir.

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>

Comentários

Use o OnSendingMail método para modificar a mensagem de email enviada a novos usuários. A Message propriedade do MailMessageEventArgs objeto passado como o e parâmetro contém o MailMessage objeto que será enviado ao novo usuário. Modifique as propriedades do MailMessage objeto para modificar a mensagem de email.

As mensagens de email só são criadas quando a BodyFileName propriedade do MailDefinition objeto especificado pela MailDefinition propriedade aponta para um nome de arquivo válido.

A geração de um evento invoca o manipulador de eventos por meio de um delegado. Para obter mais informações, consulte Manipulando e levantando eventos.

O OnSendingMail método também permite que classes derivadas manipulem o evento sem anexar um delegado. Essa é a técnica preferencial para lidar com o evento em uma classe derivada.

Notas aos Herdeiros

Ao substituir OnSendingMail(MailMessageEventArgs) em uma classe derivada, chame o método da OnSendingMail(MailMessageEventArgs) classe base para que os delegados registrados recebam o evento.

Aplica-se a

Confira também