Класс MailEnvelope

Статья
04/27/2010

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

Пространство имен: Microsoft.Office.InfoPath
Сборка: Microsoft.Office.InfoPath (в microsoft.office.infopath.dll)

Синтаксис

'Декларация
Public MustInherit Class MailEnvelope
'Применение
Dim instance As MailEnvelope

public abstract class MailEnvelope

Заметки

Класс MailEnvelope предоставляет свойства, которые можно использовать для программного создания настраиваемого сообщения электронной почты для вложения и отправки текущей открытой формы InfoPath. После указания адресов электронной почты и других свойств при установке для свойства Visible класса MailEnvelope значения true будут отображены поля сообщения электронной почты, панель инструментов и область задач наряду с формой, чтобы пользователи могли затем проверить и внести изменения или добавления к сообщению электронной почти перед его отправкой. Составление программы для работы с объектом MailEnvelope эквивалентно использованию команды в меню при редактировании формы в InfoPath.

Заметка
Класс MailEnvelope нельзя использовать для отправки сообщений электронной почты, которые он создает; пользователи должны вручную отправлять сообщения электронной почты, нажимая кнопку в приложении InfoPath.

Дополнительно, можно использовать метод ShowMailItem класса View для программного создания сообщения электронной почты с вложенной формой. Или, если настройка шаблона формы предусматривает его отправку в качестве сообщения электронной почты, можно использовать свойства и методы класса EmailSubmitConnection для программного создания и отправки формы как вложения электронной почты.

Пример

В следующем примере свойство EmailSubmitConnection класса Window используется для установки ссылки на объект MailEnvelope для текущей формы. Свойство Available используется для определения того, открыта ли форма в приложении Microsoft Office Outlook 2007. В этом случае, свойство Available возвратит значение false, и следующий код не выполняется. Если свойство Available возвращает значение true, форма отрыта в InfoPath, и указываются начальные значения адреса, темы и введения к тексту сообщения. Затем используется свойство EmailAttachmentType класса MailEnvelope, чтобы настроить сообщение для включения данных формы и шаблона формы. Наконец, для свойства Visible класса MailEnvelope устанавливается значение true, чтобы отобразить поля сообщения электронной почты, панель инструментов и область задач и пользователь мог отправить сообщение электронной почты из InfoPath.

// Set a reference to MailEnvelope object.
MailEnvelope myEnvelope = this.Application.ActiveWindow.MailEnvelope;

// Check to see if form is open in Outlook 2007.
if (myEnvelope.Available)
{
   // Specify addresses, subject, and introduction.
   myEnvelope.To = "someone@example.com";
   myEnvelope.CC = "someone@example.com";
   myEnvelope.BCC = "someone@example.com";
   myEnvelope.Subject = "Open this form";
   myEnvelope.Introduction = "InfoPath is required to edit this form.";

   // Include form template with form.
   myEnvelope.EmailAttachmentType = EmailAttachmentType.XmlXsn;

   // Display form with e-mail envelope.
   myEnvelope.Visible = true;
}
else
{
   // The form is open in Outlook 2007, and code will not run.
   MessageBox.Show("This form is open in Outlook 2007.");
}

' Set a reference to MailEnvelope object.
Dim myEnvelope As MailEnvelope  = _
   Me.Application.ActiveWindow.MailEnvelope;

' Check to see if form is open in Outlook 2007.
If (myEnvelope.Available) Then
   ' Specify addresses, subject, and introduction.
   myEnvelope.To = "someone@example.com"
   myEnvelope.CC = "someone@example.com"
   myEnvelope.BCC = "someone@example.com"
   myEnvelope.Subject = "Open this form"
   myEnvelope.Introduction = "InfoPath is required to edit this form."

   ' Include form template with form.
   myEnvelope.EmailAttachmentType = EmailAttachmentType.XmlXsn

   ' Display form with e-mail envelope.
   myEnvelope.Visible = True
Else
   ' The form is open in Outlook 2007, and code will not run.
   MessageBox.Show("This form is open in Outlook 2007.")
End If

Иерархия наследования

System.Object
Microsoft.Office.InfoPath.MailEnvelope

Безопасность потока

Все открытые статические (Общие в Visual Basic) члены этого типа потокобезопасны. Потокобезопасность членов экземпляров не гарантируется.

См. также

Ссылка

Члены MailEnvelope
Пространство имен Microsoft.Office.InfoPath

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