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 an 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
Ein MailMessageEventArgs, das die Ereignisdaten enthält.
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. Dieses Beispiel erfordert eine Textdatei namens MailFile.txt, 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 E-Mail-Nachricht zu ändern, die an neue Benutzer gesendet wird. Die Message -Eigenschaft des -Objekts, das MailMessageEventArgse
als 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.
Durch das Auslösen eines Ereignisses wird der Ereignishandler über einen Delegaten aufgerufen. Weitere Informationen finden Sie unter Behandeln und Auslösen von Ereignissen.
Mit der OnSendingMail-Methode können auch abgeleitete Klassen das Ereignis ohne Anfügen eines Delegaten behandeln. Dies ist das bevorzugte Verfahren für die Behandlung des Ereignisses in einer abgeleiteten Klasse.
Hinweise für Vererber
Achten Sie beim Überschreiben OnSendingMail(MailMessageEventArgs) in einer abgeleiteten Klasse darauf, die Methode der Basisklasse OnSendingMail(MailMessageEventArgs) aufzurufen, damit registrierte Delegaten das Ereignis empfangen.