CreateUserWizard.MailDefinition Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém uma referência a um conjunto de propriedades que definem as características da mensagem de email enviada aos novos utilizadores.
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 MailDefinitionValor de Propriedade
Uma referência a um MailDefinition objeto que define a mensagem de email enviada a um novo utilizador.
- Atributos
Exceções
From não está definido para um endereço de email.
Exemplos
O seguinte exemplo de código define propriedades da MailDefinition propriedade usando tanto a sintaxe declarativa como a programática. Este exemplo de código requer um ficheiro de texto chamado MailFile.txt que contenha o texto seguinte.
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>
Observações
A MailDefinition propriedade devolve uma referência a um grupo de propriedades que utiliza para definir o formato e o conteúdo da mensagem de email enviada a novos utilizadores. As definições comuns incluem a linha de assunto e o endereço de remetente do remetente. Para uma lista completa de propriedades, consulte a MailDefinition classe.
A MailDefinition propriedade é só de leitura; no entanto, pode definir as propriedades do MailDefinition objeto que ela devolve. Pode definir as MailDefinition propriedades declarativamente na forma Property-Subproperty, onde Subproperty representa uma propriedade da MailDefinition classe (por exemplo, MailDefinition-Subject). Também pode definir as propriedades programaticamente na forma Property.SubProperty (por exemplo, MailDefinition.Subject).
Uma mensagem de email é enviada aos novos utilizadores apenas se MailDefinition não null estiver e se Body não estiver vazia ou null. Nesse caso, o SendingMail evento é levantado e faz-se uma tentativa de enviar a mensagem de email. A From propriedade deve ser definida para um endereço de email. Caso contrário, é lançada uma HttpException exceção.
Quando a mensagem de email é criada a partir do MailDefinition objeto, ela fará as substituições listadas na tabela seguinte.
| Texto de substituição | Substituído por |
|---|---|
<%UserName%> |
O nome de utilizador da conta de utilizador recém-criada. |
<%Password%> |
A palavra-passe da conta de utilizador recém-criada. |
Se a IsBodyHtml propriedade do MailDefinition objeto for true, o conteúdo da mensagem de e-mail será codificado em HTML para proteger contra vulnerabilidades de segurança de scripting cruzado para o destinatário da mensagem.
Pode usar o OnSendingMail método para modificar o MailMessage que é criado pelo MailDefinition objeto.
Esta propriedade não pode ser definida por temas ou temas de folhas de estilo. Para mais informações, consulte ThemeableAttribute e ASP.NET Temas e Skins.
Note
Não é possível garantir que um utilizador receberá ou verá uma mensagem de email. Para verificar se um utilizador recebeu uma notificação por email, considere fornecer um link de confirmação na mensagem que permita ao utilizador confirmar que a notificação foi recebida.