CreateUserWizard.MailDefinition Propriété
Définition
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.
Obtient une référence à une collection de propriétés qui définissent les caractéristiques du message électronique 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.MailDefinitionPublic ReadOnly Property MailDefinition As MailDefinitionValeur de propriété
Référence à un MailDefinition objet qui définit le message électronique envoyé à un nouvel utilisateur.
- Attributs
Exceptions
From n’est pas défini sur une adresse e-mail.
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é 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 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 renvoie. Vous pouvez définir les MailDefinition propriétés de manière déclarative dans le formulaire 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 s’il MailDefinition n’est pas null et s’il 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 , les substitutions sont 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 se 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 la MailMessage création par l’objet MailDefinition .
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 et peaux.
Note
Il n’est pas possible de garantir qu’un utilisateur reçoit ou affiche 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.
