MailDefinition.CreateMailMessage Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает сообщение электронной почты, которое отправляется по протоколу 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.MailMessagePublic Function CreateMailMessage (recipients As String, replacements As IDictionary, owner As Control) As MailMessageПараметры
- recipients
- String
Список получателей сообщения, разделенных запятыми.
- replacements
- IDictionary
Объект IDictionary, содержащий список строк и их строки замены.
- owner
- Control
Объект Control, которому принадлежит данный объект MailDefinition.
Возвращаемое значение
Сообщение электронной почты из текстового файла.
Исключения
Параметр replacements не содержит строки.
Значение From в разделе SMTP файла конфигурации равно null или пустой строке ("").
-или-
Параметр recipients содержит неверный адрес электронной почты.
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.MailMessagePublic 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.
Возвращаемое значение
Сообщение электронной почты с заменами из текстового файла.
Исключения
Параметр replacements не содержит строки.
Значение From в разделе SMTP файла конфигурации равно null или пустой строке ("").
-или-
Параметр recipients содержит неверный адрес электронной почты.
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 .