CreateUserWizard.OnSendingMail(MailMessageEventArgs) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Löst das SendingMail Ereignis aus, bevor eine E-Mail-Nachricht an einen neuen Benutzer gesendet wird.
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)
Parameter
A MailMessageEventArgs containing the event data.
Beispiele
Im folgenden Codebeispiel wird ein benutzerdefiniertes CreateUserWizard Steuerelement definiert, das die OnSendingMail Methode verwendet, um den Text der an neue Benutzer gesendeten E-Mail zu ändern. In diesem Beispiel ist eine Textdatei mit dem Namen MailFile.txt erforderlich, die den folgenden Text enthält.
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>
Hinweise
Verwenden Sie die OnSendingMail Methode, um die an neue Benutzer gesendete E-Mail-Nachricht zu ändern. Die Message Eigenschaft des MailMessageEventArgs Objekts, das als e Parameter übergeben wird, enthält das MailMessage Objekt, das an den neuen Benutzer gesendet wird. Ändern Sie die Eigenschaften des MailMessage Objekts, um die E-Mail-Nachricht zu ändern.
E-Mail-Nachrichten werden nur erstellt, wenn die BodyFileName Eigenschaft des MailDefinition durch die MailDefinition Eigenschaft angegebenen Objekts auf einen gültigen Dateinamen verweist.
Das Auslösen eines Ereignisses ruft den Ereignishandler über einen Delegaten auf. Weitere Informationen finden Sie unter Behandeln und Auslösen von Ereignissen.
Mit der OnSendingMail Methode können abgeleitete Klassen auch das Ereignis behandeln, ohne einen Delegaten anzufügen. Dies ist die bevorzugte Technik für die Behandlung des Ereignisses in einer abgeleiteten Klasse.
Hinweise für Vererber
Achten Sie darauf, beim Überschreiben OnSendingMail(MailMessageEventArgs) in einer abgeleiteten Klasse die Methode der Basisklasse OnSendingMail(MailMessageEventArgs) aufzurufen, damit registrierte Delegates das Ereignis empfangen.