MailEnvelope Classe

Definição

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Representa uma mensagem de email personalizada para enviar o formulário atual como um anexo.

public abstract class MailEnvelope

Herança

Object

MailEnvelope

Exemplos

No exemplo a seguir, a EmailSubmitConnection propriedade da Window classe é usada para definir uma referência ao objeto MailEnvelope para o formulário atual. A Available propriedade é usada para determinar se o formulário é aberto no Microsoft Office Outlook 2007. Se assim for, a propriedade Available retornará false e o código a seguir não será executado. Se a propriedade Available retornar true, o formulário será aberto no InfoPath e os valores de endereço, assunto e introdução iniciais serão especificados. Em seguida, a EmailAttachmentType propriedade da classe MailEnvelope é usada para configurar a mensagem para incluir os dados do formulário e o modelo de formulário. Por fim, a propriedade Visible da classe MailEnvelope é definida como true para exibir os campos de mensagens de email, Enviar barra de ferramentas e painel de tarefas Opções de Email para o usuário para enviar a mensagem de email do 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

Comentários

A classe MailEnvelope fornece propriedades que podem ser usadas para criar programaticamente uma mensagem de email personalizada para anexar e enviar o formulário InfoPath aberto no momento. Depois que quaisquer endereços de email e outras propriedades forem especificados, definir a Visible propriedade da classe MailEnvelope como true exibirá os campos de mensagens de email, enviar barra de ferramentas e o painel de tarefas Opções de Email junto com o formulário para que os usuários possam inspecionar e fazer quaisquer alterações ou adições à mensagem de email antes de enviá-la. Escrever código para trabalhar com um objeto MailEnvelope é equivalente a usar o comando Enviar para Destinatário de Email no menu Arquivo ao editar um formulário no InfoPath.

Observação: a classe MailEnvelope não pode ser usada para enviar as mensagens de email que ela cria; os usuários devem enviar manualmente as mensagens de email clicando no botão Enviar no InfoPath.

Como alternativa, você pode usar o ShowMailItem(String, String, String, String, String) método da View classe para criar programaticamente uma mensagem de email com um formulário anexado. Ou, se o modelo de formulário tiver sido configurado para ser enviado como uma mensagem de email, você poderá usar as propriedades e os EmailSubmitConnection métodos da classe para criar e enviar o formulário de forma programática como um anexo de email.

Construtores

MailEnvelope()

Representa uma mensagem de email personalizada para enviar o formulário atual como um anexo.

Propriedades

Available	Obtém se as outras propriedades da MailEnvelope classe estão disponíveis para o código em execução no formulário.
Bcc	Obtém ou define os endereços BCC (cópia de carbono cego) da mensagem de email.
CC	Obtém ou define os endereços CC (cópia de carbono) da mensagem de email.
EmailAttachmentType	Obtém ou define o tipo de arquivo a ser anexado à mensagem de email.
Introduction	Obtém ou define a introdução no corpo da mensagem de email.
Subject	Obtém ou define o assunto da mensagem de email.
To	Obtém ou define os endereços dos destinatários da mensagem de email.
Visible	Obtém ou define a visibilidade dos campos de mensagens de email, barra de ferramentas Enviar e Painel de tarefas Opções de Email.

Aplica-se a