CreateUserWizard.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, содержащий следующий текст.

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 темы и обложки.

Примечание

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

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

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