MailDefinition.CreateMailMessage Metodo

Definizione

Crea un messaggio di posta elettronica da inviare mediante il protocollo SMTP (Simple Mail Transfer Protocol).Creates an email message to send by means of SMTP (Simple Mail Transfer Protocol).

Overload

CreateMailMessage(String, IDictionary, Control)

Crea un messaggio di posta elettronica da un file di testo da inviare mediante il protocollo SMTP (Simple Mail Transfer Protocol).Creates an email message from a text file to send by means of SMTP (Simple Mail Transfer Protocol).

CreateMailMessage(String, IDictionary, String, Control)

Crea un messaggio di posta elettronica con sostituzioni da un file di testo da inviare mediante il protocollo SMTP (Simple Mail Transfer Protocol).Creates an email message with replacements from a text file to send by means of SMTP (Simple Mail Transfer Protocol).

CreateMailMessage(String, IDictionary, Control)

Crea un messaggio di posta elettronica da un file di testo da inviare mediante il protocollo SMTP (Simple Mail Transfer Protocol).Creates an email message from a text file to send by means of 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

Parametri

recipients
String

Elenco separato da virgole dei destinatari del messaggio.A comma-separated list of message recipients.

replacements
IDictionary

Oggetto IDictionary che contiene un elenco di stringhe e le relative stringhe di sostituzione.An IDictionary containing a list of strings and their replacement strings.

owner
Control

Oggetto Control che possiede questo MailDefinition.The Control that owns this MailDefinition.

Restituisce

Messaggio di posta elettronica da un file di testo.The email message from a text file.

Eccezioni

replacements non contiene stringhe.replacements does not contain strings.

Il valore From nella sezione SMTP del file di configurazione è null oppure una stringa vuota.The From value in the SMTP section of the configuration file is null or the empty string

-oppure--or-

recipients contiene un indirizzo di posta elettronica errato.recipients contains an incorrect email address.

owner è null.owner is null.

Esempio

Nell'esempio di codice seguente viene creato un oggetto ListDictionary che definisce due stringhe ("<% a% >" e "<% da% >") che vengono sostituite nel messaggio di posta elettronica.The following code example creates a ListDictionary object that defines two strings ("<%To%>" and "<%From%>") that are replaced in the email message.

Questo esempio di codice fa parte di un esempio più ampio fornito per la classe MailDefinition.This code example is part of a larger example provided for the MailDefinition class.

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)

Nell'esempio di codice seguente viene usato il metodo CreateMailMessage per creare un nuovo messaggio di posta elettronica da un file di testo.The following code example uses the CreateMailMessage method to create a new email message from a text file.

Questo esempio di codice fa parte di un esempio più ampio fornito per la classe MailDefinition.This code example is part of a larger example provided for the MailDefinition class.

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)

Commenti

Il metodo CreateMailMessage crea un nuovo oggetto MailMessage che può essere inviato utilizzando il metodo SmtpClient.Send.The CreateMailMessage method creates a new MailMessage object that can be sent using the SmtpClient.Send method.

È necessario impostare la proprietà BodyFormat per indicare se il messaggio di posta elettronica deve essere formattato come testo normale (MailFormat.Text) o HTML (MailFormat.Html).The BodyFormat property must be set to indicate whether the mail message should be formatted as plain text (MailFormat.Text) or HTML (MailFormat.Html).

Il parametro recipients contiene un elenco delimitato da virgole di destinatari del messaggio di posta elettronica.The recipients parameter contains a comma-separated list of recipients of the email message. Se il recipients parametro contiene un indirizzo di posta elettronica Internet formattato in modo errato, il metodo Send genera un'eccezione HttpException e il messaggio di posta elettronica non viene inviato.If the recipients parameter contains an improperly formatted Internet email address, the Send method throws an HttpException exception and the email message is not sent.

Il parametro replacements è un'istanza di IDictionary contenente un elenco di stringhe da sostituire.The replacements parameter is an IDictionary instance that contains a list of strings to substitute. Le stringhe vengono sostituite nell'ordine in cui sono state aggiunte alla raccolta di IDictionary e possono sovrascrivere le sostituzioni precedenti.Strings are replaced in the order in which they were added to the IDictionary collection, and they can overwrite earlier replacements.

Il parametro owner indica quale controllo è l'elemento padre del controllo MailDefinition.The owner parameter indicates which control is the parent of the MailDefinition control. Determina la directory in cui cercare il file di testo specificato nella proprietà BodyFileName.It determines which directory to search for the text file specified in the BodyFileName property.

Vedi anche

CreateMailMessage(String, IDictionary, String, Control)

Crea un messaggio di posta elettronica con sostituzioni da un file di testo da inviare mediante il protocollo SMTP (Simple Mail Transfer Protocol).Creates an email message with replacements from a text file to send by means of 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

Parametri

recipients
String

Elenco di destinatari separato da virgole.The comma-separated list of recipients.

replacements
IDictionary

Oggetto IDictionary che contiene un elenco di stringhe e le relative stringhe di sostituzione.An IDictionary containing a list of strings and their replacement strings.

body
String

Testo del messaggio di posta elettronica.The text of the email message.

owner
Control

Oggetto Control che possiede questo MailDefinition.The Control that owns this MailDefinition.

Restituisce

Messaggio di posta elettronica con sostituzioni da un file di testo.The email message with replacements from a text file.

Eccezioni

replacements non contiene stringhe.replacements does not contain strings.

Il valore From nella sezione SMTP del file di configurazione è null oppure una stringa vuota ("").The From value in the SMTP section of the configuration file is null or an empty string ("").

-oppure--or-

recipients contiene un indirizzo di posta elettronica errato.recipients contains an incorrect email address.

owner è null.owner is null.

Esempio

Nell'esempio di codice seguente viene creato un oggetto ListDictionary che definisce due stringhe ("<% a% >" e "<% da% >") che vengono sostituite nel messaggio di posta elettronica.The following code example creates a ListDictionary object that defines two strings ("<%To%>" and "<%From%>") that are replaced in the email message.

Questo esempio di codice fa parte di un esempio più ampio fornito per la classe MailDefinition.This code example is part of a larger example provided for the MailDefinition class.

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)

Nell'esempio di codice seguente viene usato il metodo CreateMailMessage per creare un nuovo messaggio di posta elettronica dal testo immesso in un controllo TextBox in una pagina Web Form.The following code example uses the CreateMailMessage method to create a new email message from text entered in a TextBox control on a Web Forms page.

Questo esempio di codice fa parte di un esempio più ampio fornito per la classe MailDefinition.This code example is part of a larger example provided for the MailDefinition class.

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)

Commenti

Il metodo CreateMailMessage crea un nuovo oggetto MailMessage che può essere inviato con il metodo SmtpClient.Send.The CreateMailMessage method creates a new MailMessage object that can be sent with the SmtpClient.Send method.

Il parametro recipients contiene un elenco delimitato da virgole di destinatari del messaggio di posta elettronica.The recipients parameter contains a comma-separated list of recipients of the email message. Se il recipients parametro contiene un indirizzo di posta elettronica Internet formattato in modo errato, il metodo Send genera un'eccezione HttpException e il messaggio di posta elettronica non viene inviato.If the recipients parameter contains an improperly formatted Internet email address, the Send method throws an HttpException exception and the email message is not sent.

Il parametro replacements è un'istanza di IDictionary contenente un elenco di stringhe da sostituire.The replacements parameter is an IDictionary instance that contains a list of strings to substitute. Le stringhe vengono sostituite nell'ordine in cui sono state aggiunte alla raccolta di IDictionary e possono sovrascrivere le sostituzioni precedenti.Strings are replaced in the order in which they were added to the IDictionary collection, and they can overwrite earlier replacements.

Il parametro body contiene il testo del messaggio di posta elettronica.The body parameter contains the text of the email message.

Il parametro owner indica quale controllo è l'elemento padre del controllo MailDefinition.The owner parameter indicates which control is the parent of the MailDefinition control. Determina la directory in cui cercare il file di testo specificato nella proprietà BodyFileName.It determines which directory to search for the text file specified in the BodyFileName property.

Vedi anche

Si applica a