Páginas Web ASP.NET - Objeto WebMail

Usando o objeto WebMail, você pode enviar e-mails facilmente a partir da página da web.

Descrição

WebMail oferece métodos para construir e enviar e-mails usando o protocolo de transferência de e-mail simples (SMTP).

Exemplo

Consulte Web Pages E-mail Exemplo neste capítulo.

Manual do objeto WebMail - Propriedades

Propriedade Descrição
EnableSsl True, se o servidor usar criptografia SSL.
From Obtém ou define o endereço de e-mail do remetente.
Password Obtém ou define a senha da conta de e-mail do remetente.
SmtpPort Obtém ou define a porta usada para transações SMTP.
SmtpServer Obtém ou define o nome do servidor SMTP usado para transmitir e-mails.
UserName Obtém ou define o nome da conta de e-mail usada para enviar e-mails.

Manual do WebMail - Métodos

Método Descrição
Send() Envia o e-mail especificado para o servidor SMTP de transmissão.

O método Send() tem os seguintes parâmetros:

Parâmetros Tipo Descrição
to Cadeia de caracteres Endereço de e-mail do destinatário. Separados por ponto e vírgula (;).
subject Cadeia de caracteres Linha de assunto.
body Cadeia de caracteres Corpo do e-mail.

E os seguintes parâmetros opcionais:

Parâmetros Tipo Descrição
from Cadeia de caracteres Endereço de e-mail do remetente.
cc Cadeia de caracteres Endereços de e-mail para os quais o e-mail será copiado; separados por ponto e vírgula (;).
filesToAttach Conjunto Conjunto de nomes de arquivos usado para especificar os arquivos a serem anexados ao e-mail.
isBodyHtml Valor lógico Se for true, especifica que o corpo do e-mail é no formato HTML.
additionalHeaders Conjunto Conjunto de cabeçalhos que pode ser adicionado aos cabeçalhos normais do e-mail incluído.
bcc Cadeia de caracteres Endereço de e-mail de outros destinatários a quem será enviada uma cópia “em segredo” do e-mail.
contentEncoding Cadeia de caracteres Codificação usada para o corpo do e-mail.
headerEncoding Cadeia de caracteres Codificação usada para o cabeçalho do e-mail.
priority Cadeia de caracteres Valor usado para especificar a prioridade do e-mail.
replyTo Cadeia de caracteres Endereço de e-mail que será usado quando o destinatário responder ao e-mail.

Dados técnicos

Nome Valor
Class System.Web.Helpers.WebMail
Namespace System.Web.Helpers
Assembly System.Web.Helpers.dll

Inicializar o Assistente de WebMail

Para usar o Assistente de WebMail, você precisa acessar um servidor SMTP. O SMTP é a parte “saída” do e-mail. Se você estiver usando um web host, você pode já ter obtido o nome do servidor SMTP. Se você estiver na rede da empresa, é necessário consultar o departamento de TI para obter o nome do servidor SMTP. Se você estiver trabalhando em casa, pode usar provedores de e-mail comuns.

Para enviar e-mails, você precisa:

  • Nome do servidor SMTP
  • Número da porta (geralmente 25)
  • Nome de usuário de e-mail
  • Senha de e-mail

No diretório raiz do site, crie (ou edite) uma página chamada _AppStart.cshtml:

Escreva o seguinte código neste arquivo:

_AppStart.cshtml

@}
WebMail.SmtpServer = "smtp.example.com";
WebMail.SmtpPort = 25;
WebMail.EnableSsl = false;
WebMail.UserName = "support@example.com";
WebMail.Password = "password";
WebMail.From = "john@example.com"
}

O site (aplicativo) executará o código acima toda vez que o site for iniciado. Ele fará com que Objeto WebMailpara inicialização.

Substitua:

smtp.example.com Para o nome do servidor SMTP que será usado para enviar e-mails.

25 Para o número da porta que o servidor usará para lidar com transações SMTP (e-mails).

false Para true, se o servidor usar camada de socket seguro (SSL) para criptografar a conexão ao enviar e-mails.

support@example.com Para o nome da conta de e-mail SMTP usada para enviar e-mails.

password Para a senha da conta de e-mail SMTP.

john@example Para o endereço de e-mail do remetente.

Dica:Você não precisa inicializar o objeto WebMail no arquivo AppStart, mas deve configurar essas propriedades antes de chamar o método WebMail.Send().