MailDefinition.CreateMailMessage 方法

定義

命名空間:

System.Web.UI.WebControls

組件:

System.Web.dll

建立要透過 SMTP (簡易郵件傳輸通訊協定) 傳送的電子郵件訊息。

多載

CreateMailMessage(String, IDictionary, Control)	從文字檔建立要透過 SMTP (簡易郵件傳輸通訊協定) 傳送的電子郵件訊息。
CreateMailMessage(String, IDictionary, String, Control)	從文字檔使用取代文字建立要透過 SMTP (簡易郵件傳輸通訊協定) 傳送的電子郵件訊息。

CreateMailMessage(String, IDictionary, Control)

從文字檔建立要透過 SMTP (簡易郵件傳輸通訊協定) 傳送的電子郵件訊息。

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

參數

recipients

String

訊息收件者的逗號分隔清單。

replacements

IDictionary

IDictionary，包含字串及其取代字串的清單。

owner

Control

擁有這個 Control 的 MailDefinition。

傳回

MailMessage

來自文字檔案的電子郵件訊息。

例外狀況

ArgumentException

replacements 不包含字串。

HttpException

組態檔之 SMTP 區段中的 From 值為 null 或空字串。

-或-

recipients 包含不正確的電子郵件地址。

ArgumentNullException

owner 為 null。

範例

下列程式碼範例會建立 物件，定義電子郵件訊息中取代的兩個 ListDictionary 字串 (「 <%To%> 」 和 「 <%From%> 」) 。

此程式碼範例是針對 類別提供的較大範例的 MailDefinition 一部分。

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)

下列程式碼範例會 CreateMailMessage 使用 方法來從文字檔建立新的電子郵件訊息。

此程式碼範例是針對 類別提供的較大範例的 MailDefinition 一部分。

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)

備註

方法 CreateMailMessage 會建立可使用 方法傳送 SmtpClient.Send 的新 MailMessage 物件。

BodyFormat屬性必須設定，以指出郵件訊息是否應該格式化為純文字 (MailFormat.Text) 或 HTML (MailFormat.Html) 。

參數 recipients 包含電子郵件訊息收件者的逗號分隔清單。 recipients如果 參數包含格式不正確的網際網路電子郵件地址， Send 此方法會 HttpException 擲回例外狀況，而且不會傳送電子郵件訊息。

參數 replacements 是 IDictionary 實例，其中包含要取代的字串清單。 字串會依照新增至 IDictionary 集合的順序來取代，而且可以覆寫先前的取代專案。

參數 owner 會指出哪個控制項是控制項的 MailDefinition 父代。 它會決定要搜尋 屬性中指定的文字檔的 BodyFileName 目錄。

另請參閱

• SmtpClient
• MailMessage
• EmbeddedMailObject

CreateMailMessage(String, IDictionary, String, Control)

從文字檔使用取代文字建立要透過 SMTP (簡易郵件傳輸通訊協定) 傳送的電子郵件訊息。

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

參數

recipients

String

收件者的逗號分隔清單。

replacements

IDictionary

IDictionary，包含字串及其取代字串的清單。

body

String

電子郵件訊息的文字。

owner

Control

擁有這個 Control 的 MailDefinition。

傳回

MailMessage

含有來自文字檔案之取代項目的電子郵件訊息。

例外狀況

ArgumentException

replacements 不包含字串。

HttpException

組態檔之 SMTP 區段中的 From 值為 null 或空字串 ("")。

-或-

recipients 包含不正確的電子郵件地址。

ArgumentNullException

owner 為 null。

範例

下列程式碼範例會建立 物件，定義電子郵件訊息中取代的兩個 ListDictionary 字串 (「 <%To%> 」 和 「 <%From%> 」) 。

此程式碼範例是針對 類別提供的較大範例的 MailDefinition 一部分。

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)

下列程式碼範例會 CreateMailMessage 使用 方法，從Web Form頁面上控制項中 TextBox 輸入的文字建立新的電子郵件訊息。

此程式碼範例是針對 類別提供的較大範例的 MailDefinition 一部分。

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)

備註

方法 CreateMailMessage 會建立可使用 方法傳送 SmtpClient.Send 的新 MailMessage 物件。

參數 recipients 包含電子郵件訊息收件者的逗號分隔清單。 recipients如果 參數包含格式不正確的網際網路電子郵件地址， Send 此方法會 HttpException 擲回例外狀況，而且不會傳送電子郵件訊息。

參數 replacements 是 IDictionary 實例，其中包含要取代的字串清單。 字串會依照新增至 IDictionary 集合的順序來取代，而且可以覆寫先前的取代專案。

參數 body 包含電子郵件訊息的文字。

參數 owner 會指出哪個控制項是控制項的 MailDefinition 父代。 它會決定要搜尋 屬性中指定的文字檔的 BodyFileName 目錄。

另請參閱

• SmtpClient
• MailMessage
• EmbeddedMailObject