PasswordRecovery.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 das mensagens de email usadas para enviar senhas novas ou recuperadas para os 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 SendingMail evento para definir a mensagem de email de senha definindo subpropriedades da MailDefinition propriedade .

<%@ 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 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 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 MailDefinition classe .

Essa propriedade é somente leitura; no entanto, você pode definir as propriedades do MailDefinition objeto que ele retorna. Você pode definir essas propriedades declarativamente no formulário 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).

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 MailDefinition objeto , 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.
<%Password%> A senha recuperada para o usuário.

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.

Aplica-se a

Confira também