Partager via

PasswordRecovery.MailDefinition Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtient une référence à une collection de propriétés qui définissent les caractéristiques des messages électroniques utilisés pour envoyer des mots de passe nouveaux ou récupérés aux utilisateurs.

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

Valeur de propriété

MailDefinition

Référence à un MailDefinition qui contient des propriétés qui définissent les caractéristiques des messages électroniques utilisés pour envoyer leurs mots de passe aux utilisateurs.

Attributs
PersistenceModeAttribute ThemeableAttribute

Exemples

L’exemple de code suivant utilise l’événement SendingMail pour définir le message électronique de mot de passe en définissant des sous-propriétés de la propriété 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>

Remarques

La propriété MailDefinition retourne une référence à un groupe de propriétés que vous utilisez pour définir le format et le contenu du message électronique de mot de passe envoyé aux utilisateurs. Les paramètres courants incluent la ligne d’objet et l’adresse de retour de l’expéditeur. Pour obtenir la liste complète des propriétés, consultez la classe MailDefinition.

Cette propriété est en lecture seule ; Toutefois, vous pouvez définir les propriétés de l’objet MailDefinition qu’il retourne. Vous pouvez définir ces propriétés de manière déclarative dans le formulaire Property-Subproperty, où Subproperty représente une propriété de la classe MailDefinition (par exemple, MailDefinition-Subject). Vous pouvez également définir les propriétés par programmation dans le formulaire Property.Subproperty (par exemple, MailDefinition.Subject).

Cette propriété ne peut pas être définie par des thèmes ou des thèmes de feuille de style. Pour plus d’informations, consultez ThemeableAttribute et ASP.NET Thèmes etSkins .

Lorsque le message électronique est créé à partir de l’objet MailDefinition, les substitutions sont affichées dans le tableau suivant. Le texte de substitution ne respecte pas la casse.

Texte de substitution Remplacé par
<%UserName%> Nom d’utilisateur du site web de l’utilisateur.
<%%> mot de passe Mot de passe récupéré pour l’utilisateur.

Si la propriété IsBodyHtml de l’objet MailDefinition est true, le contenu du message électronique est encodé au format HTML pour se protéger contre les vulnérabilités de sécurité de script intersites pour le destinataire du message.

S’applique à

Voir aussi