CreateUserWizard.MailDefinition Propriedade

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtém uma referência a uma coleção de propriedades que definem as características da mensagem de email enviada aos novos usuários.

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

Valor da propriedade

MailDefinition

Uma referência a um MailDefinition objeto que define a mensagem de email enviada a um novo usuário.

Atributos
PersistenceModeAttribute ThemeableAttribute

Exceções

HttpException

From não é definido como um endereço de email.

Exemplos

O exemplo de código a seguir define as propriedades da MailDefinition propriedade usando a sintaxe declarativa e programática. Este exemplo de código requer um arquivo de texto chamado MailFile.txt que contém o texto a seguir.

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>

Comentários

A MailDefinition propriedade retorna uma referência a um grupo de propriedades que você usa para definir o formato e o conteúdo da mensagem de email que é enviada a novos usuários. As configurações comuns incluem a linha de assunto e o endereço de retorno do remetente. Para obter uma lista completa de propriedades, consulte a MailDefinition classe .

A MailDefinition propriedade é somente leitura; no entanto, você pode definir as propriedades do MailDefinition objeto que ela retorna. Você pode definir as MailDefinition propriedades declarativamente no formato Property-Subproperty, em que Subproperty representa uma propriedade da MailDefinition classe (por exemplo, MailDefinition-Subject). Você também pode definir as propriedades programaticamente no formulário Property.SubProperty (por exemplo, MailDefinition.Subject).

Uma mensagem de email será enviada a novos usuários somente se MailDefinition não null estiver e se Body não estiver vazia ou null. Nesse caso, o SendingMail evento é gerado e é feita uma tentativa de enviar a mensagem de email. A From propriedade deve ser definida como um endereço de email. Caso contrário, uma exceção HttpException será gerada.

Quando a mensagem de email for criada a partir do MailDefinition objeto , ela fará com que as substituições sejam listadas na tabela a seguir.

Texto de substituição Substituído por
<%UserName%> O nome de usuário da conta de usuário recém-criada.
<%Password%> A senha da conta de usuário recém-criada.

Se a IsBodyHtml propriedade do MailDefinition objeto for true, o conteúdo da mensagem de email será codificado em HTML para proteger contra vulnerabilidades de segurança de script entre sites para o destinatário da mensagem.

Você pode usar o OnSendingMail método para modificar o MailMessage criado pelo MailDefinition objeto .

Essa propriedade não pode ser definida por temas ou temas de folha de estilos. Para obter mais informações, consulte ThemeableAttribute e ASP.NET Temas e Capas.

Observação

Não é possível garantir que um usuário receberá ou exibirá uma mensagem de email. Para verificar se um usuário recebeu uma notificação por email, considere fornecer um link de confirmação na mensagem de email que permite ao usuário confirmar que a notificação foi recebida.

Aplica-se a

Confira também