Assembly: System.Web (in system.web.dll)
<ThemeableAttribute(False)> _ Public ReadOnly Property MailDefinition As MailDefinition
Dim instance As CreateUserWizard Dim value As MailDefinition value = instance.MailDefinition
[ThemeableAttribute(false)] public MailDefinition MailDefinition { get; }
[ThemeableAttribute(false)] public: property MailDefinition^ MailDefinition { MailDefinition^ get (); }
/** @property */ public MailDefinition get_MailDefinition ()
public function get MailDefinition () : MailDefinition
Valore proprietà
Riferimento a un oggetto MailDefinition che definisce il messaggio di posta elettronica inviato a un nuovo utente.| Tipo di eccezione | Condizione |
|---|---|
| La proprietà From non è impostata su un indirizzo di posta elettronica. |
La proprietà MailDefinition restituisce un riferimento al gruppo di proprietà utilizzato per definire il formato e il contenuto del messaggio di posta elettronica inviato ai nuovi utenti. Le impostazioni comuni includono la riga dell'oggetto e l'indirizzo del mittente. Per un elenco completo delle proprietà, vedere la classe MailDefinition.
Sebbene la proprietà MailDefinition sia in sola lettura, è possibile impostare le proprietà dell'oggetto MailDefinition che tale proprietà restituisce. È possibile impostare le proprietà MailDefinition in modo dichiarativo nel formato Property-Subproperty, dove Subproperty rappresenta una proprietà della classe MailDefinition (ad esempio MailDefinition-Subject). È anche possibile impostare le proprietà a livello di codice nel formato Property.SubProperty (ad esempio MailDefinition.Subject).
Il messaggio di posta elettronica viene inviato solo ai nuovi utenti se la proprietà BodyFileName della proprietà MailDefinition punta a un file valido. Se la proprietà BodyFileName è impostata, la proprietà From deve essere impostata su un indirizzo di posta elettronica. In caso contrario, viene generata un'eccezione HttpException.
Se il messaggio di posta elettronica viene creato a partire dall'oggetto MailDefinition, verranno effettuate le seguenti sostituzioni.
| Testo da sostituire | Sostituito con |
|---|---|
| <%UserName%> | Nome utente dell'account utente appena creato. |
| <%Password%> | Password dell'account utente appena creato. |
È possibile utilizzare il metodo OnSendingMail per modificare l'oggetto MailMessage creato dall'oggetto MailDefinition.
Questa proprietà non può essere impostata da temi oppure temi di fogli di stile. Per ulteriori informazioni, vedere ThemeableAttribute e Cenni preliminari su temi e interfacce ASP.NET.
Nell'esempio di codice riportato di seguito vengono impostate le proprietà della proprietà MailDefinition utilizzando sia la sintassi dichiarativa sia quella a livello di codice. Questo esempio di codice richiede un file di testo denominato MailFile.txt che contiene il testo riportato di seguito.
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 non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.