MailEnvelope, classe
Représente un message électronique personnalisé pour l'envoi du formulaire actif sous forme de pièce jointe.
Hiérarchie d'héritage
System.Object
Microsoft.Office.InfoPath.MailEnvelope
Espace de noms : Microsoft.Office.InfoPath
Assembly : Microsoft.Office.InfoPath (dans Microsoft.Office.InfoPath.dll)
Syntaxe
'Déclaration
Public MustInherit Class MailEnvelope
'Utilisation
Dim instance As MailEnvelope
public abstract class MailEnvelope
Remarques
La classe MailEnvelope comprend des propriétés permettant de créer par programmation un message électronique personnalisé en y joignant le formulaire InfoPath ouvert. Une fois les adresses de messagerie et d'autres propriétés spécifiées, la définition de la propriété Visible de la classe MailEnvelope avec la valeur true entraîne l'affichage des champs du message, de la barre d'outils Envoyer et du volet Office Options du message ainsi que du formulaire, afin que les utilisateurs puissent revoir, modifier et compléter le message avant envoi. Le code écrit pour fonctionner avec un objet MailEnvelope correspond à la commande Envoyer au destinataire du message du menu Fichier lors de l'édition d'un formulaire dans InfoPath.
Notes
La classe MailEnvelope ne peut pas être utilisée pour envoyer les messages électroniques qu'elle crée ; les utilisateurs doivent les envoyer manuellement avec le bouton Envoyer dans InfoPath.
Vous pouvez également utiliser la méthode ShowMailItem de la classe View pour créer un message électronique par programmation, avec un formulaire en pièce jointe. D'autre part, si le modèle de formulaire a été configuré pour l'envoi en tant que message électronique, vous pouvez utiliser les propriétés et les méthodes de la classe EmailSubmitConnection pour créer et envoyer le formulaire par programmation sous forme de pièce jointe.
Exemples
Dans l'exemple suivant, la propriété EmailSubmitConnection de la classe Window est utilisée pour définir une référence à l'objet MailEnvelope pour le formulaire actif. La propriété Available est utilisée pour déterminer si le formulaire est ouvert dans Microsoft Office Outlook 2007. Si c'est le cas, la propriété Available renverra false et le code suivant ne s'exécutera pas. Si la propriété Available renvoie true, le formulaire s'ouvre dans InfoPath et les valeurs d'adresse initiale, d'objet et d'introduction sont spécifiées. La propriété EmailAttachmentType de la classe MailEnvelope est utilisée pour configurer le message pour inclure à la fois les données et le modèle du formulaire. Enfin, la propriété Visible de la classe MailEnvelope prend la valeur true pour afficher les champs du message électronique, la barre d'outils Envoyer et le volet Office Options du message pour que l'utilisateur envoie son message depuis 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
Sécurité des threads
Tout membre static (Shared dans Visual Basic) public de ce type garantit la sécurité des threads. Il n'est pas garanti que les membres d'instance soient sécurisés au niveau des threads.