MailDefinition.CreateMailMessage Metodo

Definizione

Spazio dei nomi:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Crea un messaggio di posta elettronica da inviare mediante il protocollo 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).
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).

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

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.

replacements

IDictionary

Oggetto IDictionary che contiene un elenco di stringhe e le relative stringhe di sostituzione.

owner

Control

Oggetto Control che possiede questo MailDefinition.

Restituisce

MailMessage

Messaggio di posta elettronica da un file di testo.

Eccezioni

ArgumentException

replacements non contiene stringhe.

HttpException

Il valore From nella sezione SMTP del file di configurazione è null oppure una stringa vuota.

-oppure-

recipients contiene un indirizzo di posta elettronica errato.

ArgumentNullException

owner è null.

Esempio

Nell'esempio di codice seguente viene creato un ListDictionary oggetto che definisce due stringhe ("<%To%>" e "<%From%>") sostituite nel messaggio di posta elettronica.

Questo esempio di codice fa parte di un esempio più grande fornito per la 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)

Nell'esempio di codice seguente viene usato il CreateMailMessage metodo per creare un nuovo messaggio di posta elettronica da un file di testo.

Questo esempio di codice fa parte di un esempio più grande fornito per la 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)

Commenti

Il CreateMailMessage metodo crea un nuovo MailMessage oggetto che può essere inviato usando il SmtpClient.Send metodo .

La BodyFormat proprietà deve essere impostata per indicare se il messaggio di posta elettronica deve essere formattato come testo normale () o HTML (MailFormat.TextMailFormat.Html).

Il recipients parametro contiene un elenco delimitato da virgole dei destinatari del messaggio di posta elettronica. Se il recipients parametro contiene un indirizzo di posta elettronica Internet formattato in modo non corretto, il Send metodo genera un'eccezione HttpException e il messaggio di posta elettronica non viene inviato.

Il parametro è un'istanza replacements IDictionary che contiene un elenco di stringhe da sostituire. Le stringhe vengono sostituite nell'ordine IDictionary in cui sono state aggiunte alla raccolta e possono sovrascrivere le sostituzioni precedenti.

Il owner parametro indica quale controllo è l'elemento padre del MailDefinition controllo. Determina quale directory cercare il file di testo specificato nella BodyFileName proprietà.

Vedi anche

• SmtpClient
• MailMessage
• EmbeddedMailObject

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

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.

replacements

IDictionary

Oggetto IDictionary che contiene un elenco di stringhe e le relative stringhe di sostituzione.

body

String

Testo del messaggio di posta elettronica.

owner

Control

Oggetto Control che possiede questo MailDefinition.

Restituisce

MailMessage

Messaggio di posta elettronica con sostituzioni da un file di testo.

Eccezioni

ArgumentException

replacements non contiene stringhe.

HttpException

Il valore From nella sezione SMTP del file di configurazione è null oppure una stringa vuota ("").

-oppure-

recipients contiene un indirizzo di posta elettronica errato.

ArgumentNullException

owner è null.

Esempio

Nell'esempio di codice seguente viene creato un ListDictionary oggetto che definisce due stringhe ("<%To%>" e "<%From%>") sostituite nel messaggio di posta elettronica.

Questo esempio di codice fa parte di un esempio più grande fornito per la 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)

Nell'esempio di codice seguente viene usato il CreateMailMessage metodo per creare un nuovo messaggio di posta elettronica dal testo immesso in un TextBox controllo in una pagina Web Forms.

Questo esempio di codice fa parte di un esempio più grande fornito per la 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)

Commenti

Il CreateMailMessage metodo crea un nuovo MailMessage oggetto che può essere inviato con il SmtpClient.Send metodo .

Il recipients parametro contiene un elenco delimitato da virgole dei destinatari del messaggio di posta elettronica. Se il recipients parametro contiene un indirizzo di posta elettronica Internet formattato in modo non corretto, il Send metodo genera un'eccezione HttpException e il messaggio di posta elettronica non viene inviato.

Il parametro è un'istanza replacements IDictionary che contiene un elenco di stringhe da sostituire. Le stringhe vengono sostituite nell'ordine IDictionary in cui sono state aggiunte alla raccolta e possono sovrascrivere le sostituzioni precedenti.

Il body parametro contiene il testo del messaggio di posta elettronica.

Il owner parametro indica quale controllo è l'elemento padre del MailDefinition controllo. Determina quale directory cercare il file di testo specificato nella BodyFileName proprietà.

Vedi anche

• SmtpClient
• MailMessage
• EmbeddedMailObject