CreateUserWizard.MailDefinition Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém uma referência a uma coleção de propriedades que definem as características da mensagem de email enviada aos novos usuários.
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 da propriedade
Uma referência a um MailDefinition objeto que define a mensagem de email enviada a um novo usuário.
- Atributos
Exceções
From não é definido como um endereço de email.
Exemplos
O exemplo de código a seguir define as propriedades da MailDefinition propriedade usando a sintaxe declarativa e programática. Este exemplo de código requer um arquivo de texto chamado MailFile.txt que contém o texto a seguir.
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>
Comentários
A MailDefinition propriedade retorna uma referência a um grupo de propriedades que você usa para definir o formato e o conteúdo da mensagem de email enviada a novos usuários. As configurações comuns incluem a linha de assunto e o endereço de retorno do remetente. Para obter uma lista completa de propriedades, consulte a MailDefinition classe .
A MailDefinition propriedade é somente leitura; no entanto, você pode definir as propriedades do MailDefinition objeto que ela retorna. Você pode definir as MailDefinition propriedades declarativamente no formulário Property-Subproperty, em que Subproperty representa uma propriedade da MailDefinition classe (por exemplo, MailDefinition-Subject). Você também pode definir as propriedades programaticamente no formulário Property.SubProperty (por exemplo, MailDefinition.Subject).
Uma mensagem de email será enviada para novos usuários somente se MailDefinition não null estiver e se Body não estiver vazia ou null. Nesse caso, o SendingMail evento é gerado e é feita uma tentativa de enviar a mensagem de email. A From propriedade deve ser definida como um endereço de email. Caso contrário, uma exceção HttpException será gerada.
Quando a mensagem de email for criada a partir do MailDefinition objeto , ela fará as substituições listadas na tabela a seguir.
| Texto de substituição | Substituído por |
|---|---|
<%UserName%> |
O nome de usuário da conta de usuário recém-criada. |
<%Password%> |
A senha da conta de usuário recém-criada. |
Se a IsBodyHtml propriedade do MailDefinition objeto for true, o conteúdo da mensagem de email será codificado em HTML para proteger contra vulnerabilidades de segurança de script entre sites para o destinatário da mensagem.
Você pode usar o OnSendingMail método para modificar o MailMessage criado pelo MailDefinition objeto .
Essa propriedade não pode ser definida por temas ou temas de folha de estilos. Para obter mais informações, consulte ThemeableAttribute e ASP.NET Temas e Peles.
Observação
Não é possível garantir que um usuário receberá ou exibirá uma mensagem de email. Para verificar se um usuário recebeu uma notificação por email, considere fornecer um link de confirmação na mensagem de email que permite que o usuário confirme se a notificação foi recebida.
