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如果参数包含格式不正确的 Internet 电子邮件地址，该方法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 Forms页上控件中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 创建一个新 MailMessage 对象，该对象可以使用该方法 SmtpClient.Send 发送。

该 recipients 参数包含电子邮件收件人的逗号分隔列表。 recipients如果参数包含格式不正确的 Internet 电子邮件地址，该方法Send将HttpException引发异常，并且不会发送电子邮件。

参数 replacements 是包含 IDictionary 要替换的字符串列表的实例。 字符串按添加到 IDictionary 集合的顺序替换，并且可以覆盖以前的替换项。

此参数 body 包含电子邮件的文本。

此参数 owner 指示哪个控件是控件的父级 MailDefinition 。 它确定要搜索属性中指定的文本文件的 BodyFileName 目录。

另请参阅

• SmtpClient
• MailMessage
• EmbeddedMailObject