Bagikan melalui

MailDefinition.CreateMailMessage Metode

Definisi

Ruang nama:
System.Web.UI.WebControls
Rakitan:
System.Web.dll

Membuat pesan email untuk dikirim melalui SMTP (Simple Mail Transfer Protocol).

Overload

Nama Deskripsi
CreateMailMessage(String, IDictionary, Control)

Membuat pesan email dari file teks untuk dikirim melalui SMTP (Simple Mail Transfer Protocol).
CreateMailMessage(String, IDictionary, String, Control)

Membuat pesan email dengan penggantian dari file teks untuk dikirim melalui SMTP (Simple Mail Transfer Protocol).

CreateMailMessage(String, IDictionary, Control)

Membuat pesan email dari file teks untuk dikirim melalui 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

Parameter

recipients
String

Daftar penerima pesan yang dipisahkan koma.

replacements
IDictionary

Berisi IDictionary daftar string dan string penggantinya.

owner
Control

Yang Control memiliki ini MailDefinition.

Mengembalikan

MailMessage

Pesan email dari file teks.

Pengecualian

ArgumentException

replacements tidak berisi string.

HttpException

Nilai From di bagian SMTP dari file konfigurasi adalah null atau string kosong

-atau-

recipients berisi alamat email yang salah.

ArgumentNullException

owner adalah null.

Contoh

Contoh kode berikut membuat ListDictionary objek yang menentukan dua string ("<%To%>" dan "<%From%>") yang diganti dalam pesan email.

Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan untuk MailDefinition kelas .

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)

Contoh kode berikut menggunakan CreateMailMessage metode untuk membuat pesan email baru dari file teks.

Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan untuk MailDefinition kelas .

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)

Keterangan

Metode ini CreateMailMessage membuat objek baru MailMessage yang dapat dikirim menggunakan SmtpClient.Send metode .

Properti BodyFormat harus diatur untuk menunjukkan apakah pesan email harus diformat sebagai teks biasa (MailFormat.Text) atau HTML (MailFormat.Html).

Parameter recipients berisi daftar penerima pesan email yang dipisahkan koma. recipients Jika parameter berisi alamat email Internet yang diformat dengan tidak benar, Send metode melemparkan HttpException pengecualian dan pesan email tidak dikirim.

Parameter replacements adalah IDictionary instans yang berisi daftar string untuk diganti. String diganti dalam urutan penambahannya ke IDictionary koleksi, dan dapat menimpa penggantian sebelumnya.

Parameter owner menunjukkan kontrol mana yang merupakan induk kontrol MailDefinition . Ini menentukan direktori mana yang akan dicari untuk file teks yang ditentukan dalam BodyFileName properti .

Lihat juga

Berlaku untuk

CreateMailMessage(String, IDictionary, String, Control)

Membuat pesan email dengan penggantian dari file teks untuk dikirim melalui 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

Parameter

recipients
String

Daftar penerima yang dipisahkan koma.

replacements
IDictionary

Berisi IDictionary daftar string dan string penggantinya.

body
String

Teks pesan email.

owner
Control

Yang Control memiliki ini MailDefinition.

Mengembalikan

MailMessage

Pesan email dengan penggantian dari file teks.

Pengecualian

ArgumentException

replacements tidak berisi string.

HttpException

Nilai From di bagian SMTP dari file konfigurasi adalah null atau string kosong ("").

-atau-

recipients berisi alamat email yang salah.

ArgumentNullException

owner adalah null.

Contoh

Contoh kode berikut membuat ListDictionary objek yang menentukan dua string ("<%To%>" dan "<%From%>") yang diganti dalam pesan email.

Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan untuk MailDefinition kelas .

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)

Contoh kode berikut menggunakan CreateMailMessage metode untuk membuat pesan email baru dari teks yang TextBox dimasukkan dalam kontrol pada halaman Formulir Web.

Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan untuk MailDefinition kelas .

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)

Keterangan

Metode ini CreateMailMessage membuat objek baru MailMessage yang dapat dikirim dengan SmtpClient.Send metode .

Parameter recipients berisi daftar penerima pesan email yang dipisahkan koma. recipients Jika parameter berisi alamat email Internet yang diformat dengan tidak benar, Send metode melemparkan HttpException pengecualian dan pesan email tidak dikirim.

Parameter replacements adalah IDictionary instans yang berisi daftar string untuk diganti. String diganti dalam urutan penambahannya ke IDictionary koleksi, dan dapat menimpa penggantian sebelumnya.

Parameter body berisi teks pesan email.

Parameter owner menunjukkan kontrol mana yang merupakan induk kontrol MailDefinition . Ini menentukan direktori mana yang akan dicari untuk file teks yang ditentukan dalam BodyFileName properti .

Lihat juga

Berlaku untuk