CreateUserWizard.MailDefinition Propriété

Référence

Définition

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

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Apporte une référence à une collection de propriétés qui définissent les caractéristiques de l’e-mail envoyé aux nouveaux 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 objet qui définit l’e-mail envoyé à un nouvel utilisateur.

Attributs: PersistenceModeAttribute ThemeableAttribute

Exceptions

HttpException

Aucune adresse e-mail n’est affectée à la propriété From.

Exemples

L’exemple de code suivant définit les propriétés de la propriété à l’aide de la MailDefinition syntaxe déclarative et programmatique. Cet exemple de code nécessite un fichier texte nommé MailFile.txt qui contient le texte suivant.

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>

Remarques

La MailDefinition propriété renvoie une référence à un groupe de propriétés que vous utilisez pour définir le format et le contenu du message électronique envoyé aux nouveaux 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 MailDefinition classe .

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

Un e-mail est envoyé aux nouveaux utilisateurs uniquement si MailDefinition n’est pas null et si Body n’est pas vide ou null. Dans ce cas, l’événement SendingMail est déclenché et une tentative d’envoi du message électronique est effectuée. La From propriété doit être définie sur une adresse e-mail. Sinon, une HttpException exception est levée.

Lorsque le message électronique est créé à partir de l’objet MailDefinition , il effectue les substitutions répertoriées dans le tableau suivant.

Texte de substitution	Remplacé par
`<%UserName%>`	Nom d’utilisateur du compte d’utilisateur nouvellement créé.
`<%Password%>`	Mot de passe du compte d’utilisateur nouvellement créé.

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

Vous pouvez utiliser la OnSendingMail méthode pour modifier le MailMessage créé par l’objet MailDefinition .

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

Notes

Il n’est pas possible de garantir qu’un utilisateur recevra ou verra un e-mail. Pour vérifier qu’un utilisateur a reçu une notification par e-mail, envisagez de fournir un lien de confirmation dans le message électronique qui permet à l’utilisateur de confirmer que la notification a été reçue.

S’applique à