MailDefinition.CreateMailMessage Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.MailMessagePublic Function CreateMailMessage (recipients As String, replacements As IDictionary, owner As Control) As MailMessagePará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
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.MailMessagePublic Function CreateMailMessage (recipients As String, replacements As IDictionary, body As String, owner As Control) As MailMessagePará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
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 .