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 objeto 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 SendingMail evento para definir el mensaje de correo electrónico de contraseña estableciendo subpropiedades de la MailDefinition propiedad .

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

Esta propiedad es de solo lectura; sin embargo, puede establecer las propiedades del MailDefinition objeto que devuelve. Puede establecer estas propiedades mediante declaración en el formulario Property-Subproperty, donde Subproperty representa una propiedad de la MailDefinition clase (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 o temas de la hoja de estilos. Para obtener más información, consulte ThemeableAttribute y ASP.NET Temas y máscaras.

Cuando se crea el mensaje de correo electrónico a partir del MailDefinition objeto , 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.
<%Password%> Contraseña recuperada para el usuario.

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

Se aplica a

Consulte también