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 Если параметр содержит неправильно отформатированный адрес электронной почты Интернета, метод выдает HttpException исключение, Send а сообщение электронной почты не отправляется.
Параметр 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 Если параметр содержит неправильно отформатированный адрес электронной почты Интернета, метод выдает HttpException исключение, Send а сообщение электронной почты не отправляется.
Параметр replacements — это IDictionary экземпляр, содержащий список строк для замены. Строки заменяются в том порядке, в котором они были добавлены в IDictionary коллекцию, и они могут перезаписать более ранние замены.
Параметр body содержит текст сообщения электронной почты.
Параметр owner указывает, какой элемент управления является родительским элементом MailDefinition элемента управления. Он определяет, какой каталог следует искать текстовый файл, указанный в свойстве BodyFileName .
