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 является и если Body не является пустым или null. В этом случае SendingMail возникает событие и предпринимается попытка отправить сообщение электронной почты. Для From свойства должен быть задан адрес электронной почты. В противном HttpException случае возникает исключение.
При создании сообщения электронной почты из MailDefinition объекта будут созданы подстановки, перечисленные в следующей таблице.
| Текст подстановки | Заменено на |
|---|---|
<%UserName%> |
Имя пользователя только что созданной учетной записи пользователя. |
<%Password%> |
Пароль для созданной учетной записи пользователя. |
IsBodyHtml Если свойство MailDefinition объекта равно true, содержимое почтового сообщения будет закодировано в ФОРМАТЕ HTML, чтобы защититься от уязвимостей системы безопасности межустраничного скрипта для получателя сообщения.
Метод можно использовать для OnSendingMail изменения созданного MailMessageMailDefinition объектом .
Значение для данного свойства нельзя задать с помощью тем или тем таблиц стилей. Дополнительные сведения см. в разделе ThemeableAttribute и ASP.NET темы и обложки.
Примечание
Невозможно гарантировать, что пользователь получит или просмотрет сообщение электронной почты. Чтобы убедиться, что пользователь получил уведомление по электронной почте, рекомендуется предоставить ссылку для подтверждения в сообщении электронной почты, которая позволит пользователю подтвердить получение уведомления.
