Поделиться через

ChangePassword.MailDefinition Свойство

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

Возвращает ссылку на коллекцию свойств, определяющих сообщение электронной почты, которое отправляется пользователям после изменения пароля.

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.MailDefinition
Public ReadOnly Property MailDefinition As MailDefinition

Значение свойства

MailDefinition

Ссылка на объект, определяющий MailDefinition сообщение электронной почты, отправленное новому пользователю.

Атрибуты
PersistenceModeAttribute ThemeableAttribute

Исключения

HttpException

Свойство From не задано для адреса электронной почты.

Примеры

В следующем примере кода показано, как использовать MailDefinition свойство для определения сообщения электронной почты, отправляемого пользователям, которые изменяют пароли. Предполагается, что есть файл, который MailFile.txt содержит текст сообщения электронной почты для отправки.

Чтобы иметь возможность отправлять сообщения электронной почты пользователям, необходимо настроить почтовый сервер в файле Web.config приложения. Дополнительные сведения см. в разделе "Практическое руководство. Установка и настройка виртуальных серверов SMTP в IIS 6.0".

<%@ 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 Changepassword1_SendingMail(object sender, MailMessageEventArgs e)
  {
    // Set mail message fields.
    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("<%ChangedDate%>", (DateTime.Now.ToString()) );
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:changepassword id="Changepassword1" runat="server" 
        maildefinition-bodyfilename="~/MailFiles/mailfile.txt" 
          maildefinition-from="userAdmin@your.site.name.here" 
          onsendingmail="Changepassword1_SendingMail">
      </asp:changepassword>
    </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 Changepassword1_SendingMail(ByVal sender As Object, ByVal e As MailMessageEventArgs)
        ' Set mail message fields.
        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("<%ChangedDate%>", DateTime.Now.ToString())
  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:changepassword id="Changepassword1" runat="server" 
          maildefinition-bodyfilename="~/MailFiles/mailfile.txt"
          maildefinition-from="userAdmin@your.site.name.here" 
          onsendingmail="Changepassword1_SendingMail">
      </asp:changepassword>
    </div>
    </form>
</body>
</html>

Комментарии

Свойство MailDefinition возвращает ссылку на группу свойств, которые используются для определения формата и содержимого сообщения электронной почты, отправленного пользователям после изменения пароля. Общие параметры включают строку темы и возвращаемый адрес отправителя. Полный список свойств см. в разделе MailDefinition.

Свойство доступно только для чтения. Однако MailDefinition можно задать свойства возвращаемого MailDefinition объекта. Эти свойства можно задать вподпропастериисвойства формы-, где вложенный атрибут представляет свойство MailDefinition класса (например, MailDefinition-Subject). Можно также задать свойства программным способом вподпропастериисвойства. формы (например,MailDefinition.Subject ).

Сообщение электронной почты отправляется только в том случае, если у пользователя есть адрес электронной почты, зарегистрированный в поставщике членства, и если BodyFileName свойство MailDefinition свойства указывает на допустимый файл. BodyFileName Если свойство задано, From свойство должно быть задано на адрес электронной почты. В противном случае HttpException создается исключение.

Если сообщение электронной почты создается из MailDefinition объекта, оно сделает подстановки, показанные в следующей таблице. Текст подстановки не учитывает регистр.

Текст подстановки Заменено на
< UserName %%> Имя пользователя веб-сайта.
<%паролей%> Новый пароль для пользователя.

IsBodyHtml Если свойство объекта имеет значениеtrue, содержимое почтового MailDefinition сообщения будет закодировано в формате HTML для защиты от уязвимостей безопасности между сайтами для получателя сообщения.

Событие можно использовать SendingMail для изменения объекта, созданного MailMessageMailDefinition объектом.

Важный

Отправка имен учетных записей пользователей или паролей в электронной почте является потенциальной угрозой безопасности. Сообщения электронной почты обычно отправляются в виде обычного текста и могут читаться специальными приложениями сети "sniffing". Чтобы повысить безопасность, используйте способы устранения рисков, описанные в разделе "Защита элементов управления именами входа".

Это свойство не может быть задано темами или темами таблицы стилей. Дополнительные сведения см. в статье ThemeableAttributeи ASP.NET темы и скины.

Применяется к

См. также раздел