Comparteix a través de

PasswordRecovery.MailDefinition Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Obtiene una referencia a una colección de propiedades que definen las características de los mensajes de correo electrónico usados para enviar contraseñas nuevas o recuperadas a los usuarios.

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 propiedad

MailDefinition

Referencia a un MailDefinition que contiene propiedades que definen las características de los mensajes de correo electrónico usados para enviar a los usuarios sus contraseñas.

Atributos
PersistenceModeAttribute ThemeableAttribute

Ejemplos

En el ejemplo de código siguiente se usa el evento SendingMail para definir el mensaje de correo electrónico de contraseña estableciendo subpropiedades de la propiedad 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>

Comentarios

La propiedad MailDefinition devuelve una referencia a un grupo de propiedades que se usan para definir el formato y el contenido del mensaje de correo electrónico de contraseña enviado a los usuarios. La configuración común incluye la línea de asunto y la dirección de devolución del remitente. Para obtener una lista completa de las propiedades, consulte la clase MailDefinition.

Esta propiedad es de solo lectura; sin embargo, puede establecer las propiedades del objeto MailDefinition que devuelve. Puede establecer estas propiedades mediante declaración en el formulario Property-Subproperty, donde Subproperty representa una propiedad de la clase MailDefinition (por ejemplo, MailDefinition-Subject). También puede establecer las propiedades mediante programación en el formulario Property.Subproperty (por ejemplo, MailDefinition.Subject).

Esta propiedad no se puede establecer mediante temas ni temas de hojas de estilos. Para obtener más información, consulte ThemeableAttribute y temas y ASP.NET temas y máscaras.

Cuando el mensaje de correo electrónico se crea a partir del objeto MailDefinition, realizará las sustituciones que se muestran en la tabla siguiente. El texto de sustitución no distingue mayúsculas de minúsculas.

Texto de sustitución Reemplazado por
<%UserName%> Nombre de usuario del sitio web del usuario.
% de contraseña de % Contraseña recuperada para el usuario.

Si la propiedad IsBodyHtml del objeto MailDefinition es true, el contenido del mensaje de correo se codificará en HTML para protegerse frente a vulnerabilidades de seguridad de scripting entre sitios para el destinatario del mensaje.

Se aplica a

Consulte también