MailDefinition.CreateMailMessage Método

Definição

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.dll

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.MailMessage

Public Function CreateMailMessage (recipients As String, replacements As IDictionary, owner As Control) As MailMessage

Parâ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

MailMessage

A mensagem de email de um arquivo de texto.

Exceções

ArgumentException

replacements não contém cadeias de caracteres.

HttpException

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.

ArgumentNullException

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

• SmtpClient
• MailMessage
• EmbeddedMailObject

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.MailMessage

Public Function CreateMailMessage (recipients As String, replacements As IDictionary, body As String, owner As Control) As MailMessage

Parâ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

MailMessage

A mensagem de email com substituições de um arquivo de texto.

Exceções

ArgumentException

replacements não contém cadeias de caracteres.

HttpException

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.

ArgumentNullException

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.

Confira também

• SmtpClient
• MailMessage
• EmbeddedMailObject