MailDefinition.CreateMailMessage Метод

Определение

Создает сообщение электронной почты, которое отправляется по протоколу SMTP.Creates an email message to send by means of SMTP (Simple Mail Transfer Protocol).

Перегрузки

CreateMailMessage(String, IDictionary, Control)

Создает сообщение электронной почты из текстового файла, которое отправляется по протоколу SMTP.Creates an email message from a text file to send by means of SMTP (Simple Mail Transfer Protocol).

CreateMailMessage(String, IDictionary, String, Control)

Создает сообщение электронной почты с заменами из текстового файла, которое отправляется по протоколу SMTP.Creates an email message with replacements from a text file to send by means of SMTP (Simple Mail Transfer Protocol).

CreateMailMessage(String, IDictionary, Control)

Создает сообщение электронной почты из текстового файла, которое отправляется по протоколу SMTP.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

Параметры

recipients
String

Список получателей сообщения, разделенных запятыми.A comma-separated list of message recipients.

replacements
IDictionary

Объект IDictionary, содержащий список строк и их строки замены.An IDictionary containing a list of strings and their replacement strings.

owner
Control

Объект Control, которому принадлежит данный объект MailDefinition.The Control that owns this MailDefinition.

Возвращаемое значение

Сообщение электронной почты из текстового файла.The email message from a text file.

Исключения

Параметр replacements не содержит строки.replacements does not contain strings.

Значение From в разделе SMTP файла конфигурации равно null или пустой строке ("").The From value in the SMTP section of the configuration file is null or the empty string -или--or- Параметр recipients содержит неверный адрес электронной почты.recipients contains an incorrect email address.

ownernull.owner is null.

Примеры

В следующем примере кода создается ListDictionary объект, определяющий две строки ("<% to% >" и "<% от% >"), которые заменяются в сообщении электронной почты.The following code example creates a ListDictionary object that defines two strings ("<%To%>" and "<%From%>") that are replaced in the email message.

Этот пример кода является частью большого примера, 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)

В следующем примере кода CreateMailMessage метод используется для создания нового сообщения электронной почты из текстового файла.The following code example uses the CreateMailMessage method to create a new email message from a text file.

Этот пример кода является частью большого примера, 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)

Комментарии

Метод создает новый MailMessage объект, который SmtpClient.Send можно отправить с помощью метода. CreateMailMessageThe CreateMailMessage method creates a new MailMessage object that can be sent using the SmtpClient.Send method.

Свойство должно быть установлено, чтобы указать, следует ли отформатировать почтовое сообщение как обычныйMailFormat.Textтекст () илиMailFormat.HtmlHTML (). BodyFormatThe BodyFormat property must be set to indicate whether the mail message should be formatted as plain text (MailFormat.Text) or HTML (MailFormat.Html).

recipients Параметр содержит список получателей сообщения электронной почты с разделителями-запятыми.The recipients parameter contains a comma-separated list of recipients of the email message. Если параметр содержит неверно отформатированный адрес электронной почты Интернета Send , метод выдает HttpException исключение, и сообщение электронной почты не отправляется. recipientsIf the recipients parameter contains an improperly formatted Internet email address, the Send method throws an HttpException exception and the email message is not sent.

replacements Параметр —этоэкземпляр,содержащийIDictionary список строк для замены.The replacements parameter is an IDictionary instance that contains a list of strings to substitute. Строки заменяются в том порядке, в котором они были добавлены IDictionary в коллекцию, и могут перезаписывать более ранние замены.Strings are replaced in the order in which they were added to the IDictionary collection, and they can overwrite earlier replacements.

Параметр указывает, какой элемент управления является родительским MailDefinition для элемента управления. ownerThe owner parameter indicates which control is the parent of the MailDefinition control. Он определяет, какой каталог следует искать для текстового файла, указанного в BodyFileName свойстве.It determines which directory to search for the text file specified in the BodyFileName property.

Дополнительно

CreateMailMessage(String, IDictionary, String, Control)

Создает сообщение электронной почты с заменами из текстового файла, которое отправляется по протоколу SMTP.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

Параметры

recipients
String

Список получателей, разделенных запятыми.The comma-separated list of recipients.

replacements
IDictionary

Объект IDictionary, содержащий список строк и их строки замены.An IDictionary containing a list of strings and their replacement strings.

body
String

Текст сообщения электронной почты.The text of the email message.

owner
Control

Объект Control, которому принадлежит данный объект MailDefinition.The Control that owns this MailDefinition.

Возвращаемое значение

Сообщение электронной почты с заменами из текстового файла.The email message with replacements from a text file.

Исключения

Параметр replacements не содержит строки.replacements does not contain strings.

Значение From в разделе SMTP файла конфигурации равно null или пустой строке ("").The From value in the SMTP section of the configuration file is null or an empty string ("").

- или --or- Параметр recipients содержит неверный адрес электронной почты.recipients contains an incorrect email address.

ownernull.owner is null.

Примеры

В следующем примере кода создается ListDictionary объект, определяющий две строки ("<% to% >" и "<% от% >"), которые заменяются в сообщении электронной почты.The following code example creates a ListDictionary object that defines two strings ("<%To%>" and "<%From%>") that are replaced in the email message.

Этот пример кода является частью большого примера, 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)

В следующем примере кода CreateMailMessage метод используется для создания нового сообщения электронной почты на основе текста, TextBox введенного в элементе управления на странице веб-форм.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.

Этот пример кода является частью большого примера, 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)

Комментарии

Метод создает новый MailMessage объект, который SmtpClient.Send можно отправить с помощью метода. CreateMailMessageThe CreateMailMessage method creates a new MailMessage object that can be sent with the SmtpClient.Send method.

recipients Параметр содержит список получателей сообщения электронной почты с разделителями-запятыми.The recipients parameter contains a comma-separated list of recipients of the email message. Если параметр содержит неверно отформатированный адрес электронной почты Интернета Send , метод выдает HttpException исключение, и сообщение электронной почты не отправляется. recipientsIf the recipients parameter contains an improperly formatted Internet email address, the Send method throws an HttpException exception and the email message is not sent.

replacements Параметр —этоэкземпляр,содержащийIDictionary список строк для замены.The replacements parameter is an IDictionary instance that contains a list of strings to substitute. Строки заменяются в том порядке, в котором они были добавлены IDictionary в коллекцию, и могут перезаписывать более ранние замены.Strings are replaced in the order in which they were added to the IDictionary collection, and they can overwrite earlier replacements.

body Параметр содержит текст сообщения электронной почты.The body parameter contains the text of the email message.

Параметр указывает, какой элемент управления является родительским MailDefinition для элемента управления. ownerThe owner parameter indicates which control is the parent of the MailDefinition control. Он определяет, какой каталог следует искать для текстового файла, указанного в BodyFileName свойстве.It determines which directory to search for the text file specified in the BodyFileName property.

Дополнительно

Применяется к