MailDefinition.CreateMailMessage Método
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.
Cria uma mensagem de email para enviar através do SMTP (Protocolo Simples de Transferência de Correio).
Sobrecargas
| Name | Description |
|---|---|
| CreateMailMessage(String, IDictionary, Control) |
Cria uma mensagem de email a partir de um ficheiro de texto para enviar através do SMTP (Protocolo Simples de Transferência de Correio). |
| CreateMailMessage(String, IDictionary, String, Control) |
Cria uma mensagem de email com substituições a partir de um ficheiro de texto para enviar através de SMTP (Protocolo Simples de Transferência de Correio). |
CreateMailMessage(String, IDictionary, Control)
Cria uma mensagem de email a partir de um ficheiro de texto para enviar através do SMTP (Protocolo Simples de Transferência de Correio).
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írgulas dos destinatários das mensagens.
- replacements
- IDictionary
An IDictionary contendo uma lista de cordas e das suas cordas de substituição.
- owner
- Control
O Control que detém isto MailDefinition.
Devoluções
A mensagem de email de um ficheiro de texto.
Exceções
replacements não contém cordas.
O From valor na secção SMTP do ficheiro de configuração é null ou a cadeia vazia
-ou-
recipients contém um endereço de email incorreto.
owner é null.
Exemplos
O exemplo de código seguinte cria um ListDictionary objeto que define duas strings ("<%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 seguinte utiliza o CreateMailMessage método para criar uma nova mensagem de email a partir de um ficheiro 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)
Observações
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 correio deve ser formatada como texto simples (MailFormat.Text) ou HTML (MailFormat.Html).
O recipients parâmetro contém uma lista separada por vírgulas dos destinatários da mensagem de email. Se o recipients parâmetro contiver um endereço de email da Internet mal formatado, o Send método lança uma HttpException exceção e a mensagem de email não é enviada.
O replacements parâmetro é uma IDictionary instância que contém uma lista de cadeias a substituir. As cordas são substituídas pela ordem em que foram adicionadas à IDictionary coleção, podendo sobrescrever substituições anteriores.
O owner parâmetro indica qual o controlo que é o pai do MailDefinition controlo. Determina em que diretório pesquisar o ficheiro de texto especificado na BodyFileName propriedade.
Ver também
Aplica-se a
CreateMailMessage(String, IDictionary, String, Control)
Cria uma mensagem de email com substituições a partir de um ficheiro de texto para enviar através de SMTP (Protocolo Simples de Transferência de Correio).
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írgulas de destinatários.
- replacements
- IDictionary
An IDictionary contendo uma lista de cordas e das suas cordas de substituição.
- body
- String
O texto da mensagem de email.
- owner
- Control
O Control que detém isto MailDefinition.
Devoluções
A mensagem de email com substituições de um ficheiro de texto.
Exceções
replacements não contém cordas.
O From valor na secção SMTP do ficheiro de configuração é null ou uma cadeia vazia ("").
-ou-
recipients contém um endereço de email incorreto.
owner é null.
Exemplos
O exemplo de código seguinte cria um ListDictionary objeto que define duas strings ("<%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 seguinte utiliza o CreateMailMessage método para criar uma nova mensagem de email a partir de texto inserido num TextBox controlo numa 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)
Observações
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 dos destinatários da mensagem de email. Se o recipients parâmetro contiver um endereço de email da Internet mal formatado, o Send método lança uma HttpException exceção e a mensagem de email não é enviada.
O replacements parâmetro é uma IDictionary instância que contém uma lista de cadeias a substituir. As cordas são substituídas pela ordem em que foram adicionadas à IDictionary coleção, podendo sobrescrever substituições anteriores.
O body parâmetro contém o texto da mensagem de email.
O owner parâmetro indica qual o controlo que é o pai do MailDefinition controlo. Determina em que diretório pesquisar o ficheiro de texto especificado na BodyFileName propriedade.