CreateUserWizard.MailDefinition Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает ссылку на коллекцию свойств, определяющих характеристики сообщения электронной почты, отправленного новым пользователям.
public:
property System::Web::UI::WebControls::MailDefinition ^ MailDefinition { System::Web::UI::WebControls::MailDefinition ^ get(); };[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
[System.Web.UI.Themeable(false)]
public System.Web.UI.WebControls.MailDefinition MailDefinition { get; }[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
[<System.Web.UI.Themeable(false)>]
member this.MailDefinition : System.Web.UI.WebControls.MailDefinitionPublic ReadOnly Property MailDefinition As MailDefinitionЗначение свойства
Ссылка на объект, определяющий MailDefinition сообщение электронной почты, отправленное новому пользователю.
- Атрибуты
Исключения
From Не задано значение адреса электронной почты.
Примеры
В следующем примере кода задаются свойства 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="C#"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<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 = e.Message.Body.Replace("<%PasswordQuestion%>", Createuserwizard1.Question);
e.Message.Body = e.Message.Body.Replace("<%PasswordAnswer%>", Createuserwizard1.Answer);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<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="VB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<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 = e.Message.Body.Replace("<%PasswordQuestion%>", Createuserwizard1.Question)
e.Message.Body = e.Message.Body.Replace("<%PasswordAnswer%>", Createuserwizard1.Answer)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<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>
Комментарии
Свойство MailDefinition возвращает ссылку на группу свойств, которая используется для определения формата и содержимого сообщения электронной почты, отправляемого новым пользователям. Общие параметры включают строку темы и возвращаемый адрес отправителя. Полный список свойств см. в MailDefinition классе.
Свойство доступно только для чтения. Однако MailDefinition можно задать свойства возвращаемого MailDefinition объекта. Свойства можно задать MailDefinition декларативно в форме Property-Subproperty, где Subproperty представляет свойство MailDefinition класса (например, MailDefinition-Subject). Вы также можете задать свойства программным способом в форме Property.SubProperty (например, MailDefinition.Subject).
Сообщение электронной почты отправляется новым пользователям только в том случае, если MailDefinition он не null пуст или nullне является пустым.Body В этом случае SendingMail возникает событие, и предпринята попытка отправить сообщение электронной почты. Свойство From должно иметь адрес электронной почты.
HttpException В противном случае создается исключение.
При создании сообщения электронной почты из MailDefinition объекта он сделает подстановки, перечисленные в следующей таблице.
| Текст подстановки | Заменено на |
|---|---|
<%UserName%> |
Имя пользователя только что созданной учетной записи пользователя. |
<%Password%> |
Пароль для созданной учетной записи пользователя. |
IsBodyHtml Если свойство MailDefinition объекта имеет значениеtrue, содержимое сообщения электронной почты будет закодировано для защиты от уязвимостей безопасности между сайтами для получателя сообщения.
Метод можно использовать OnSendingMail для изменения созданного MailMessageMailDefinition объектом.
Это свойство не может быть задано темами или темами таблицы стилей. Дополнительные сведения см. в статье ThemeableAttributeи ASP.NET темы и скины.
Замечание
Невозможно гарантировать, что пользователь получит или просматривает сообщение электронной почты. Чтобы убедиться, что пользователь получил уведомление по электронной почте, рассмотрите возможность предоставления ссылки подтверждения в сообщении электронной почты, позволяющего пользователю подтвердить получение уведомления.
