PasswordRecovery.MailDefinition Propriedade

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém uma referência a uma coleção de propriedades que definem as características das mensagens de email usadas para enviar senhas novas ou recuperadas aos 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 que contém propriedades que definem as características das mensagens de email usadas para enviar senhas aos usuários.

Atributos: PersistenceModeAttribute ThemeableAttribute

Exemplos

O exemplo de código a seguir usa o evento SendingMail para definir a mensagem de email de senha definindo subpropriedades da propriedade MailDefinition.

<%@ 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 PasswordRecovery1_SendingMail(object sender, MailMessageEventArgs e)
  {
    e.Message.IsBodyHtml = false;
    e.Message.Subject = "New password on Web site.";
  }
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:passwordrecovery 
         id="PasswordRecovery1" 
         runat="server"
         maildefinition-from="userAdmin@your.site.name.here"
         onsendingmail="PasswordRecovery1_SendingMail">
      </asp:passwordrecovery>
    </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 PasswordRecovery1_SendingMail(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.MailMessageEventArgs)

    e.Message.IsBodyHtml = False
    e.Message.Subject = "New password on Web site."
    
  End Sub
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:passwordrecovery
         id="PasswordRecovery1" 
         runat="server" 
         maildefinition-from="userAdmin@your.site.name.here"
         onsendingmail="PasswordRecovery1_SendingMail">
      </asp:passwordrecovery>
    </form>
  </body>
</html>

Comentários

A propriedade MailDefinition retorna uma referência a um grupo de propriedades que você usa para definir o formato e o conteúdo da mensagem de email de senha enviada aos 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 classe MailDefinition.

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

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 Peles.

Quando a mensagem de email for criada a partir do objeto MailDefinition, ela fará as substituições mostradas na tabela a seguir. O texto de substituição não diferencia maiúsculas de minúsculas.

Texto de substituição	Substituído por
<%`UserName`%>	O nome de usuário do site do usuário.
<%%> de senha	A senha recuperada para o usuário.

Se a propriedade IsBodyHtml do objeto MailDefinition 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.

Aplica-se a

Confira também

MailDefinition
Visão geral dos controles de logon do ASP.NET

Partilhar via