MailDefinition.CreateMailMessage Método
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.
Cria uma mensagem de email para ser enviada por meio do protocolo SMTP.
Sobrecargas
| CreateMailMessage(String, IDictionary, Control) |
Cria uma mensagem de email de um arquivo de texto para ser enviada por meio do protocolo SMTP. |
| CreateMailMessage(String, IDictionary, String, Control) |
Cria uma mensagem de email com substituições de um arquivo de texto para ser enviada por meio do protocolo SMTP. |
CreateMailMessage(String, IDictionary, Control)
Cria uma mensagem de email de um arquivo de texto para ser enviada por meio do protocolo SMTP.
public:
System::Net::Mail::MailMessage ^ CreateMailMessage(System::String ^ recipients, System::Collections::IDictionary ^ replacements, System::Web::UI::Control ^ owner);public System.Net.Mail.MailMessage CreateMailMessage (string recipients, System.Collections.IDictionary replacements, System.Web.UI.Control owner);member this.CreateMailMessage : string * System.Collections.IDictionary * System.Web.UI.Control -> System.Net.Mail.MailMessagePublic Function CreateMailMessage (recipients As String, replacements As IDictionary, owner As Control) As MailMessageParâmetros
- recipients
- String
Uma lista separada por vírgula dos destinatários da mensagem.
- replacements
- IDictionary
Um IDictionary que contém uma lista de cadeias de caracteres e suas cadeias de caracteres substitutas.
- owner
- Control
O Control que detém este MailDefinition.
Retornos
A mensagem de email de um arquivo de texto.
Exceções
replacements não contém cadeias de caracteres.
O valo From na seção SMTP do arquivo de configuração é null ou cadeia de caracteres vazia
- ou -
recipients contém um endereço de email incorreto.
owner é null.
Exemplos
O exemplo de código a seguir cria um ListDictionary objeto que define duas cadeias de caracteres ("<%To%>" e "<%From%>") que são substituídas na mensagem de email.
Este exemplo de código faz parte de um exemplo maior fornecido para a MailDefinition classe.
ListDictionary replacements = new ListDictionary();
replacements.Add("<%To%>",sourceTo.Text);
replacements.Add("<%From%>", md.From);
Dim replacements As ListDictionary = New ListDictionary
replacements.Add("<%To%>", sourceTo.Text)
replacements.Add("<%From%>", sourceFrom.Text)
O exemplo de código a seguir usa o CreateMailMessage método para criar uma nova mensagem de email de um arquivo de texto.
Este exemplo de código faz parte de um exemplo maior fornecido para a MailDefinition classe.
System.Net.Mail.MailMessage fileMsg;
fileMsg = md.CreateMailMessage(sourceTo.Text, replacements, this);
Dim fileMsg As System.Net.Mail.MailMessage
fileMsg = md.CreateMailMessage(sourceTo.Text, replacements, Me)
Comentários
O CreateMailMessage método cria um novo MailMessage objeto que pode ser enviado usando o SmtpClient.Send método.
A BodyFormat propriedade deve ser definida para indicar se a mensagem de email deve ser formatada como texto sem formatação (MailFormat.Text) ou HTML (MailFormat.Html).
O recipients parâmetro contém uma lista separada por vírgulas de destinatários da mensagem de email. Se o recipients parâmetro contiver um endereço de email da Internet formatado incorretamente, o Send método gerará uma exceção HttpException e a mensagem de email não será enviada.
O replacements parâmetro é uma IDictionary instância que contém uma lista de cadeias de caracteres a serem substituídas. As cadeias de caracteres são substituídas na ordem em que foram adicionadas à IDictionary coleção e podem substituir substituições anteriores.
O owner parâmetro indica qual controle é o pai do MailDefinition controle. Ele determina qual diretório pesquisar o arquivo de texto especificado na BodyFileName propriedade.
Confira também
Aplica-se a
CreateMailMessage(String, IDictionary, String, Control)
Cria uma mensagem de email com substituições de um arquivo de texto para ser enviada por meio do protocolo SMTP.
public:
System::Net::Mail::MailMessage ^ CreateMailMessage(System::String ^ recipients, System::Collections::IDictionary ^ replacements, System::String ^ body, System::Web::UI::Control ^ owner);public System.Net.Mail.MailMessage CreateMailMessage (string recipients, System.Collections.IDictionary replacements, string body, System.Web.UI.Control owner);member this.CreateMailMessage : string * System.Collections.IDictionary * string * System.Web.UI.Control -> System.Net.Mail.MailMessagePublic Function CreateMailMessage (recipients As String, replacements As IDictionary, body As String, owner As Control) As MailMessageParâmetros
- recipients
- String
A lista separada por vírgula dos destinatários.
- replacements
- IDictionary
Um IDictionary que contém uma lista de cadeias de caracteres e suas cadeias de caracteres substitutas.
- body
- String
O texto da mensagem de email.
- owner
- Control
O Control que detém este MailDefinition.
Retornos
A mensagem de email com substituições de um arquivo de texto.
Exceções
replacements não contém cadeias de caracteres.
O valor From na seção SMTP do arquivo de configuração é null ou uma cadeia de caracteres vazia ("").
- ou -
recipients contém um endereço de email incorreto.
owner é null.
Exemplos
O exemplo de código a seguir cria um ListDictionary objeto que define duas cadeias de caracteres ("<%To%>" e "<%From%>") que são substituídas na mensagem de email.
Este exemplo de código faz parte de um exemplo maior fornecido para a MailDefinition classe.
ListDictionary replacements = new ListDictionary();
replacements.Add("<%To%>",sourceTo.Text);
replacements.Add("<%From%>", md.From);
Dim replacements As ListDictionary = New ListDictionary
replacements.Add("<%To%>", sourceTo.Text)
replacements.Add("<%From%>", sourceFrom.Text)
O exemplo de código a seguir usa o CreateMailMessage método para criar uma nova mensagem de email a partir do texto inserido em um TextBox controle em uma página Web Forms.
Este exemplo de código faz parte de um exemplo maior fornecido para a MailDefinition classe.
System.Net.Mail.MailMessage fileMsg;
fileMsg = md.CreateMailMessage(sourceTo.Text, replacements, this);
Dim fileMsg As System.Net.Mail.MailMessage
fileMsg = md.CreateMailMessage(sourceTo.Text, replacements, Me)
Comentários
O CreateMailMessage método cria um novo MailMessage objeto que pode ser enviado com o SmtpClient.Send método.
O recipients parâmetro contém uma lista separada por vírgulas de destinatários da mensagem de email. Se o recipients parâmetro contiver um endereço de email da Internet formatado incorretamente, o Send método gerará uma exceção HttpException e a mensagem de email não será enviada.
O replacements parâmetro é uma IDictionary instância que contém uma lista de cadeias de caracteres a serem substituídas. As cadeias de caracteres são substituídas na ordem em que foram adicionadas à IDictionary coleção e podem substituir substituições anteriores.
O body parâmetro contém o texto da mensagem de email.
O owner parâmetro indica qual controle é o pai do MailDefinition controle. Ele determina qual diretório pesquisar o arquivo de texto especificado na BodyFileName propriedade.