PasswordRecovery.MailDefinition Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.dll

Obtém uma referência a um conjunto de propriedades que definem as características das mensagens de email usadas para enviar novas ou recuperadas palavras-passe aos utilizadores.

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 de Propriedade

MailDefinition

Uma referência a a MailDefinition que contém propriedades que definem as características das mensagens de email usadas para enviar palavras-passe aos utilizadores.

Atributos
PersistenceModeAttribute ThemeableAttribute

Exemplos

O exemplo de código seguinte utiliza o SendingMail evento para definir a mensagem de email password, 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>

Observações

A MailDefinition propriedade devolve uma referência a um grupo de propriedades que utiliza para definir o formato e o conteúdo da mensagem de email por palavra-passe enviada aos utilizadores. As definições comuns incluem a linha de assunto e o endereço de remetente do remetente. Para uma lista completa de propriedades, consulte a MailDefinition classe.

Esta propriedade é apenas de leitura; no entanto, podes definir as propriedades do MailDefinition objeto que ele devolve. Pode definir estas propriedades declarativamente na forma Property-Subproperty, onde Subproperty representa uma propriedade da MailDefinition classe (por exemplo, MailDefinition-Subject). Também pode definir as propriedades programaticamente na forma Property.Subproperty (por exemplo, MailDefinition.Subject).

Esta propriedade não pode ser definida por temas ou temas de folhas de estilo. Para mais informações, consulte ThemeableAttribute e ASP.NET Temas e Skins.

Quando a mensagem de email é criada a partir do MailDefinition objeto, ela fará as substituições apresentadas na tabela seguinte. O texto de substituição é indistinto a maiúsculas e maiúsculas.

Texto de substituição Substituído por
<%UserName%> O nome de utilizador do site do utilizador.
<%Palavra-passe%> A palavra-passe recuperada para o utilizador.

Se a IsBodyHtml propriedade do MailDefinition objeto for true, o conteúdo da mensagem de e-mail será codificado em HTML para proteger contra vulnerabilidades de segurança de scripting cruzado para o destinatário da mensagem.

Aplica-se a

Ver também