Compartir a través de


MailDefinition.CreateMailMessage Método

Definición

Crea un mensaje de correo electrónico para enviarlo por SMTP (Protocolo simple de transferencia de correo).

Sobrecargas

CreateMailMessage(String, IDictionary, Control)

Crea un mensaje de correo electrónico a partir de un archivo de texto para enviarlo por SMTP (Protocolo simple de transferencia de correo).

CreateMailMessage(String, IDictionary, String, Control)

Crea un mensaje de correo electrónico con reemplazos a partir de un archivo de texto para enviarlo por SMTP (Protocolo simple de transferencia de correo).

CreateMailMessage(String, IDictionary, Control)

Crea un mensaje de correo electrónico a partir de un archivo de texto para enviarlo por SMTP (Protocolo simple de transferencia de correo).

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

Lista de destinatarios del mensaje, separada por comas.

replacements
IDictionary

Objeto IDictionary que contiene una lista de cadenas y sus cadenas de reemplazo.

owner
Control

Control propietario de esta clase MailDefinition.

Devoluciones

MailMessage

Mensaje de correo electrónico creado a partir de un archivo de texto.

Excepciones

replacements no contiene cadenas.

El valor de From de la sección SMTP del archivo de configuración es null o una cadena vacía ("").

o bien

recipients contiene una dirección de correo electrónico incorrecta.

owner es null.

Ejemplos

En el ejemplo de código siguiente se crea un ListDictionary objeto que define dos cadenas ("<%To%>" y "<%From%>") que se reemplazan en el mensaje de correo electrónico.

Este ejemplo de código forma parte de un ejemplo más grande proporcionado para la MailDefinition clase .

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)

En el ejemplo de código siguiente se usa el CreateMailMessage método para crear un nuevo mensaje de correo electrónico a partir de un archivo de texto.

Este ejemplo de código forma parte de un ejemplo más grande proporcionado para la MailDefinition clase .

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)

Comentarios

El CreateMailMessage método crea un nuevo MailMessage objeto que se puede enviar mediante el SmtpClient.Send método .

La BodyFormat propiedad debe establecerse para indicar si el mensaje de correo debe tener formato de texto sin formato (MailFormat.Text) o HTML (MailFormat.Html).

El recipients parámetro contiene una lista separada por comas de destinatarios del mensaje de correo electrónico. Si el recipients parámetro contiene una dirección de correo electrónico de Internet con un formato incorrecto, el Send método produce una HttpException excepción y el mensaje de correo electrónico no se envía.

El replacements parámetro es una IDictionary instancia de que contiene una lista de cadenas que se van a sustituir. Las cadenas se reemplazan en el orden en que se agregaron a la IDictionary colección y pueden sobrescribir reemplazos anteriores.

El owner parámetro indica qué control es el elemento primario del MailDefinition control. Determina qué directorio buscar el archivo de texto especificado en la BodyFileName propiedad .

Consulte también

Se aplica a

CreateMailMessage(String, IDictionary, String, Control)

Crea un mensaje de correo electrónico con reemplazos a partir de un archivo de texto para enviarlo por SMTP (Protocolo simple de transferencia de correo).

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

Lista de destinatarios, separada por comas.

replacements
IDictionary

Objeto IDictionary que contiene una lista de cadenas y sus cadenas de reemplazo.

body
String

Texto del mensaje de correo electrónico.

owner
Control

Control propietario de esta clase MailDefinition.

Devoluciones

MailMessage

Mensaje de correo electrónico con reemplazos obtenidos de un archivo de texto.

Excepciones

replacements no contiene cadenas.

El valor de From de la sección SMTP del archivo de configuración es null o una cadena vacía ("").

o bien

recipients contiene una dirección de correo electrónico incorrecta.

owner es null.

Ejemplos

En el ejemplo de código siguiente se crea un ListDictionary objeto que define dos cadenas ("<%To%>" y "<%From%>") que se reemplazan en el mensaje de correo electrónico.

Este ejemplo de código forma parte de un ejemplo más grande proporcionado para la MailDefinition clase .

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)

En el ejemplo de código siguiente se usa el CreateMailMessage método para crear un nuevo mensaje de correo electrónico a partir del texto escrito en un TextBox control en una página de Web Forms.

Este ejemplo de código forma parte de un ejemplo más grande proporcionado para la MailDefinition clase .

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)

Comentarios

El CreateMailMessage método crea un nuevo MailMessage objeto que se puede enviar con el SmtpClient.Send método .

El recipients parámetro contiene una lista separada por comas de destinatarios del mensaje de correo electrónico. Si el recipients parámetro contiene una dirección de correo electrónico de Internet con un formato incorrecto, el Send método produce una HttpException excepción y el mensaje de correo electrónico no se envía.

El replacements parámetro es una IDictionary instancia de que contiene una lista de cadenas que se van a sustituir. Las cadenas se reemplazan en el orden en que se agregaron a la IDictionary colección y pueden sobrescribir reemplazos anteriores.

El body parámetro contiene el texto del mensaje de correo electrónico.

El owner parámetro indica qué control es el elemento primario del MailDefinition control. Determina qué directorio buscar el archivo de texto especificado en la BodyFileName propiedad .

Consulte también

Se aplica a