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 объекта. Эти свойства можно задать ввложенном свойствеформы-, где subproperty представляет свойство MailDefinition класса (например, MailDefinition-Subject). Свойства можно также задать программным способом в формеПодсвойствосвойства. (например, ).MailDefinition.Subject

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

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

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

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

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

Важно!

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

Значение для данного свойства нельзя задать с помощью тем или тем таблиц стилей. Дополнительные сведения см. в разделе ThemeableAttribute и ASP.NET темы и обложки.

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

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