CreateUserWizard.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 del mensaje de correo electrónico enviado a nuevos 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 define el mensaje de correo electrónico enviado a un nuevo usuario.

Atributos
PersistenceModeAttribute ThemeableAttribute

Excepciones

HttpException

From no se establece en una dirección de correo electrónico.

Ejemplos

En el ejemplo de código siguiente se establecen las propiedades de la MailDefinition propiedad mediante la sintaxis declarativa y mediante programación. Este ejemplo de código requiere un archivo de texto denominado MailFile.txt que contenga el texto siguiente.

Your account was set up on our Web site with the following:

    Username:   <%UserName%>

To reset your password, you must answer the following question:

    Password Question: <%PasswordQuestion%>
    Password Answer:   <%PasswordAnswer%>

Thank you for creating an account with our Web site.

<%@ 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 Createuserwizard1_SendingMail(object sender, MailMessageEventArgs e)
  {
    // Set MailMessage fields.
    e.Message.IsBodyHtml = false;
    e.Message.Subject = "New user on Web site.";
    // Replace placeholder text in message body with information 
    // provided by the user.
    e.Message.Body = e.Message.Body.Replace("<%PasswordQuestion%>", Createuserwizard1.Question);
    e.Message.Body = e.Message.Body.Replace("<%PasswordAnswer%>",   Createuserwizard1.Answer);  
}
  
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>
      CreateUserWizard.MailDefinition sample</title>
  </head>
  <body>
    <form id="form1" runat="server">
      <div>
        <asp:createuserwizard id="Createuserwizard1" runat="server" 
          maildefinition-bodyfilename="MailFile.txt"
          maildefinition-from="userAdmin@your.site.name.here" 
          onsendingmail="Createuserwizard1_SendingMail">
        </asp:createuserwizard>
      </div>
    </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 Createuserwizard1_SendingMail(ByVal sender As Object, ByVal e As MailMessageEventArgs)
    ' Set MailMessage fields.
    e.Message.IsBodyHtml = False
    e.Message.Subject = "New user on Web site."
    ' Replace placeholder text in message body with information 
    ' provided by the user.
   e.Message.Body = e.Message.Body.Replace("<%PasswordQuestion%>", Createuserwizard1.Question)
    e.Message.Body = e.Message.Body.Replace("<%PasswordAnswer%>",   Createuserwizard1.Answer)
  End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>
      CreateUserWizard.MailDefinition sample</title>
  </head>
  <body>
    <form id="form1" runat="server">
      <div>
        <asp:createuserwizard id="Createuserwizard1" runat="server" 
          maildefinition-bodyfilename="MailFile.txt"
          maildefinition-from="userAdmin@your.site.name.here" 
          onsendingmail="Createuserwizard1_SendingMail">
        </asp:createuserwizard>
      </div>
    </form>
  </body>
</html>

Comentarios

La MailDefinition propiedad devuelve una referencia a un grupo de propiedades que se usa para definir el formato y el contenido del mensaje de correo electrónico que se envía a los nuevos 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 .

La MailDefinition propiedad es de solo lectura; sin embargo, puede establecer las propiedades del MailDefinition objeto que devuelve. Puede establecer las MailDefinition 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).

Solo se envía un mensaje de correo electrónico a los nuevos usuarios si MailDefinition no null es y si Body no está vacío o null. En ese caso, se genera el SendingMail evento y se intenta enviar el mensaje de correo electrónico. La From propiedad debe establecerse en una dirección de correo electrónico. De lo contrario, se produce una HttpException excepción.

Cuando se crea el mensaje de correo electrónico a partir del MailDefinition objeto , realizará las sustituciones enumeradas en la tabla siguiente.

Texto de sustitución Reemplazado por
<%UserName%> Nombre de usuario de la cuenta de usuario recién creada.
<%Password%> Contraseña de la cuenta de usuario recién creada.

Si la IsBodyHtml propiedad del MailDefinition objeto 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.

Puede usar el OnSendingMail método para modificar el MailMessage objeto creado por el MailDefinition objeto .

Esta propiedad no se puede establecer mediante temas o temas de la hoja de estilos. Para obtener más información, vea ThemeableAttribute y ASP.NET Temas y máscaras.

Nota

No es posible garantizar que un usuario reciba o vea un mensaje de correo electrónico. Para comprobar que un usuario ha recibido una notificación por correo electrónico, considere la posibilidad de proporcionar un vínculo de confirmación en el mensaje de correo electrónico que permite al usuario confirmar que se recibió la notificación.

Se aplica a

Consulte también