Classe MailEnvelope

Rappresenta un messaggio di posta elettronica personalizzato per l'invio del modulo corrente come allegato.

Spazio dei nomi: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Sintassi

Public MustInherit Class MailEnvelope

Dim instance As MailEnvelope

public abstract class MailEnvelope

Osservazioni

La classe MailEnvelope implementa proprietà che possono essere utilizzate per creare a livello di programmazione un messaggio di posta elettronica personalizzato per allegare e inviare il modulo di InfoPath attualmente aperto. Dopo avere specificato gli indirizzi di posta elettronica ed eventuali altre proprietà, impostando la proprietà Visible della classe MailEnvelope su true, insieme al modulo verranno visualizzati i campi del messaggio di posta elettronica, la barra degli strumenti Invia e il riquadro attività Opzioni posta, per consentire agli utenti di analizzare il messaggio di posta elettronica e apportare eventuali modifiche o aggiunte prima di inviarlo. La creazione di codice per l'utilizzo di un oggetto MailEnvelope equivale all'utilizzo del comando Invia a destinatario posta del menu File quando si modifica un modulo in InfoPath.

Nota:
La classe MailEnvelope non può essere utilizzata per inviare i messaggi di posta elettronica creati. I messaggi devono essere inviati manualmente facendo clic sul pulsante Invia in InfoPath.

In alternativa, è possibile utilizzare il metodo ShowMailItem della classe View per creare a livello di programmazione un messaggio di posta elettronica con un modulo allegato oppure, se il modello di modulo è stato configurato per essere inviato come messaggio di posta elettronica, è possibile utilizzare le proprietà e i metodi della classe EmailSubmitConnection per creare e inviare a livello di programmazione il modulo come allegato a un messaggio di posta elettronica.

Esempio

Nell'esempio seguente viene utilizzata la proprietà EmailSubmitConnection della classe Window per impostare un riferimento all'oggetto MailEnvelope per il modulo corrente. Viene utilizzata la proprietà Available per determinare se il modulo è aperto in Microsoft Office Outlook 2007. In caso affermativo, la proprietà Available restituisce false e il codice seguente non viene eseguito. Se la proprietà Available restituisce true, il modulo è aperto in InfoPath e i valori iniziali relativi a indirizzo, oggetto e introduzione sono specificati. Viene quindi utilizzata la proprietà EmailAttachmentType della classe MailEnvelope per configurare il messaggio includendo sia i dati del modulo che il modello di modulo. Infine, la proprietà Visible della classe MailEnvelope viene impostata su true per visualizzare i campi del messaggio di posta elettronica, la barra degli strumenti Invia e il riquadro attività Opzioni posta per l'invio del messaggio da 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

Gerarchia di ereditarietà

System.Object
  Microsoft.Office.InfoPath.MailEnvelope

Thread Safety

Tutti i membri statici pubblici (Shared in Visual Basic) di questo tipo sono thread-safe. I membri di istanza non sono garantiti come thread-safe.

Vedere anche

Riferimenti

Membri MailEnvelope
Spazio dei nomi Microsoft.Office.InfoPath