CreateUserWizard.OnSendingMail(MailMessageEventArgs) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
在將電子郵件訊息傳送至新使用者之前,引發 SendingMail 事件。
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)
參數
包含事件資料的 MailMessageEventArgs。
範例
下列程式代碼範例會定義自定義 CreateUserWizard 控件,該控件會使用 OnSendingMail 方法來修改傳送給新使用者的電子郵件文字。 此範例需要名為 MailFile.txt 的文字檔,其中包含下列文字。
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>
備註
OnSendingMail使用方法來修改傳送給新使用者的電子郵件訊息。
Message傳遞為 e
參數之 MailMessageEventArgs 物件的 屬性包含MailMessage將傳送給新用戶的物件。 修改物件的屬性 MailMessage ,以修改電子郵件訊息。
只有在 屬性所MailDefinition指定的 物件屬性MailDefinition指向有效的檔名時BodyFileName,才會建立電子郵件訊息。
引發事件會透過委派叫用此事件處理常式。 如需詳細資訊,請參閱 處理和引發事件。
OnSendingMail 方法也允許衍生類別處理事件,而不用附加委派。 這是在衍生類別中處理事件的慣用技巧。
給繼承者的注意事項
在衍生類別中覆 OnSendingMail(MailMessageEventArgs) 寫時,請務必呼叫基類的 OnSendingMail(MailMessageEventArgs) 方法,讓已註冊的委派接收事件。