CreateUserWizard.MailDefinition プロパティ
アセンブリ: System.Web (system.web.dll 内)
構文[ThemeableAttribute(false)] public: property MailDefinition^ MailDefinition { MailDefinition^ get (); }
新しいユーザーに送信される電子メール メッセージを定義する MailDefinition オブジェクトへの参照。
例外| 例外の種類 | 条件 |
|---|---|
HttpException | From に電子メール アドレスが設定されていません。 |
解説MailDefinition プロパティは、新規ユーザーに送信される電子メール メッセージの形式と内容を定義するために使用するプロパティのグループへの参照を返します。一般的な設定としては、件名や送信元の返信用アドレスなどがあります。プロパティの全一覧については、MailDefinition クラスを参照してください。
MailDefinition プロパティは読み取り専用です。ただし、このプロパティが返す MailDefinition オブジェクトのプロパティを設定することはできます。MailDefinition プロパティは、Property-Subproperty の形式で設定できます。ここで、Subproperty は MailDefinition クラスのプロパティを表します (例 : MailDefinition-Subject)。Property.SubProperty の形式でプロパティをプログラムから設定することもできます (例 : MailDefinition.Subject)。
MailDefinition プロパティの BodyFileName プロパティが有効なファイルを指している場合、電子メールは新規ユーザーだけに送信されます。BodyFileName プロパティを設定する場合は、From プロパティに電子メール アドレスを設定する必要があります。設定しないと、HttpException 例外がスローされます。
MailDefinition オブジェクトから電子メール メッセージを作成すると、次の置換が行われます。
OnSendingMail メソッドを使用して、MailDefinition オブジェクトによって作成される MailMessage を変更できます。
このプロパティは、テーマまたはスタイル シート テーマによって設定することはできません。詳細については、ThemeableAttribute、ASP.NET のテーマとスキンの概要 の各トピックを参照してください。
使用例宣言構文とプログラム構文の両方を使用して、MailDefinition プロパティのプロパティを設定するコード例を次に示します。このコード例では、次のテキストを含む 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="VB"%> <script runat="server"> Sub Createuserwizard1_SendingMail(ByVal sender As Object, ByVal e As MailMessageEventArgs) ' Set MailMessage fields. e.Message.IsBodyHtml = False e.Message.Subject = "New user on Web site." ' Replace placeholder text in message body with information ' provided by the user. e.Message.Body.Replace("<%PasswordQuestion%>", Createuserwizard1.Question) e.Message.Body.Replace("<%PasswordAnswer%>", Createuserwizard1.Answer) End Sub </script> <html> <head runat="server"> <title> CreateUserWizard.MailDefinition sample</title> </head> <body> <form id="form1" runat="server"> <div> <asp:createuserwizard id="Createuserwizard1" runat="server" maildefinition-bodyfilename="MailFile.txt" maildefinition-from="userAdmin@your.site.name.here" onsendingmail="Createuserwizard1_SendingMail"> </asp:createuserwizard> </div> </form> </body> </html>
<%@ page language="C#"%> <script runat="server"> void Createuserwizard1_SendingMail(object sender, MailMessageEventArgs e) { // Set MailMessage fields. e.Message.IsBodyHtml = false; e.Message.Subject = "New user on Web site."; // Replace placeholder text in message body with information // provided by the user. e.Message.Body.Replace("<%PasswordQuestion%>", Createuserwizard1.Question); e.Message.Body.Replace("<%PasswordAnswer%>", Createuserwizard1.Answer); } </script> <html> <head runat="server"> <title> CreateUserWizard.MailDefinition sample</title> </head> <body> <form id="form1" runat="server"> <div> <asp:createuserwizard id="Createuserwizard1" runat="server" maildefinition-bodyfilename="MailFile.txt" maildefinition-from="userAdmin@your.site.name.here" onsendingmail="Createuserwizard1_SendingMail"> </asp:createuserwizard> </div> </form> </body> </html>
プラットフォームWindows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- CreateUserWizard.MailDefinition プロパティのページへのリンク
