MailDefinition.CreateMailMessage Método

Definição

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Cria uma mensagem de email para enviar por meio de SMTP (Simple Mail Transfer Protocol).

Sobrecargas

Nome	Description
CreateMailMessage(String, IDictionary, Control)	Cria uma mensagem de email de um arquivo de texto para enviar por meio de SMTP (Simple Mail Transfer Protocol).
CreateMailMessage(String, IDictionary, String, Control)	Cria uma mensagem de email com substituições de um arquivo de texto para enviar por meio de SMTP (Simple Mail Transfer Protocol).

CreateMailMessage(String, IDictionary, Control)

Cria uma mensagem de email de um arquivo de texto para enviar por meio de SMTP (Simple Mail Transfer Protocol).

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írgulas de destinatários de mensagens.

replacements

IDictionary

Uma IDictionary lista contendo cadeias de caracteres e suas cadeias de caracteres de substituição.

owner

Control

O Control dono disso 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 From valor na seção SMTP do arquivo de configuração é null ou a 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 HttpException exceção 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 procurar 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 enviar por meio de SMTP (Simple Mail Transfer Protocol).

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írgulas de destinatários.

replacements

IDictionary

Uma IDictionary lista contendo cadeias de caracteres e suas cadeias de caracteres de substituição.

body

String

O texto da mensagem de email.

owner

Control

O Control dono disso 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 From valor 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 do 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 HttpException exceção 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 procurar o arquivo de texto especificado na BodyFileName propriedade.

Confira também

• SmtpClient
• MailMessage
• EmbeddedMailObject