MailEnvelope 类

定义

命名空间:

Microsoft.Office.InfoPath

程序集:

Microsoft.Office.InfoPath.dll

代表用于以附件形式发送当前表单的自定义电子邮件。

public ref class MailEnvelope abstract

public abstract class MailEnvelope

type MailEnvelope = class

Public MustInherit Class MailEnvelope

继承

Object

MailEnvelope

示例

在以下示例中， EmailSubmitConnection 类的 Window 属性用于设置对当前窗体的 MailEnvelope 对象的引用。 属性 Available 用于确定是否在 Microsoft Office Outlook 2007 中打开窗体。 如果已打开，Available 属性将返回 false，并且以下代码将不会运行。 如果 Available 属性返回 true，则表单在 InfoPath 中已打开，并且指定了初始地址、主题和介绍值。 然后， EmailAttachmentType 使用 MailEnvelope 类的 属性将邮件配置为包含表单数据和表单模板。 最后，MailEnvelope 类的 Visible 属性设置为 true，以便向用户显示电子邮件字段、“发送工具栏”和“邮件选项”任务窗格，以便从 InfoPath 发送电子邮件。

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

// Check to see if form is open in Outlook.
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, and code will not run.
   MessageBox.Show("This form is open in Outlook.");
}

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

' Check to see if form is open in Outlook.
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, and code will not run.
   MessageBox.Show("This form is open in Outlook.")
End If

注解

MailEnvelope 类提供了很多属性，可以用来通过编程的方式创建自定义电子邮件，用于附加和发送当前打开的 InfoPath 表单。 指定任何电子邮件地址和其他属性后，将 MailEnvelope 类的 属性设置为 Visibletrue 将显示电子邮件字段、“发送工具栏”和“邮件选项”任务窗格以及表单，以便用户可以在发送电子邮件之前对其进行检查并对其进行任何更改或添加。 编写代码以使用 MailEnvelope 对象等效于在 InfoPath 中编辑表单时使用“文件”菜单上的“发送到邮件收件人”命令。

注意： MailEnvelope 类不能用于发送它创建的电子邮件;用户必须通过单击 InfoPath 中的“发送”按钮手动发送电子邮件。

或者，可以使用 ShowMailItem(String, String, String, String, String) 类的 View 方法以编程方式创建带有附加窗体的电子邮件。 或者，如果表单模板已配置为作为电子邮件提交，则可以使用 类的属性和方法 EmailSubmitConnection 以编程方式创建表单并将其作为电子邮件附件发送。

构造函数

MailEnvelope()

代表用于以附件形式发送当前表单的自定义电子邮件。

属性

Available	获取 类的其他属性 MailEnvelope 是否可用于在窗体中运行的代码。
Bcc	获取或设置电子邮件的密件抄送 (BCC) 地址。
CC	获取或设置电子邮件的抄送 (CC) 地址。
EmailAttachmentType	获取或设置要附加到电子邮件的文件的类型。
Introduction	获取或设置电子邮件正文中的介绍。
Subject	获取或设置电子邮件的主题。
To	获取或设置电子邮件收件人的地址。
Visible	获取或设置电子邮件字段、“发送”工具栏和“邮件选项”任务窗格的可见性。