Поделиться через

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

Значение From в разделе SMTP файла конфигурации равно 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 создает новый MailMessage объект, который можно отправить с помощью SmtpClient.Send метода.

Свойство BodyFormat должно быть задано, чтобы указать, должно ли сообщение быть отформатировано как обычный текст (MailFormat.Text) или HTML (MailFormat.Html).

Параметр recipients содержит разделенный запятыми список получателей сообщения электронной почты. recipients Если параметр содержит неправильно отформатированный интернет-адрес электронной почты, Send метод выдает HttpException исключение и сообщение электронной почты не отправляется.

Параметр replacements — это IDictionary экземпляр, содержащий список строк для замены. Строки заменяются в том порядке, в котором они были добавлены в коллекцию IDictionary , и они могут перезаписать более ранние замены.

Параметр owner указывает, какой элемент управления является родительским элементом MailDefinition элемента управления. Он определяет каталог для поиска текстового файла, указанного в свойстве BodyFileName .

См. также раздел

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

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

Значение From в разделе SMTP файла конфигурации равно 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 метод для создания сообщения электронной почты из текста, введенного 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 Если параметр содержит неправильно отформатированный интернет-адрес электронной почты, Send метод выдает HttpException исключение и сообщение электронной почты не отправляется.

Параметр replacements — это IDictionary экземпляр, содержащий список строк для замены. Строки заменяются в том порядке, в котором они были добавлены в коллекцию IDictionary , и они могут перезаписать более ранние замены.

Параметр body содержит текст сообщения электронной почты.

Параметр owner указывает, какой элемент управления является родительским элементом MailDefinition элемента управления. Он определяет каталог для поиска текстового файла, указанного в свойстве BodyFileName .

См. также раздел

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