Méthode Attachments.Add (Outlook)

Crée une pièce jointe dans la collection Attachments .

Syntaxe

expression. Add (Source, Type, Position, DisplayName)

Expression Variable qui représente un objet Attachments .

Parameters

Nom	Requis/Facultatif	Type de données	Description
Source	Obligatoire	Variant	Source de la pièce jointe. Il peut s’agir d’un fichier (représenté par le chemin d’accès au système de fichiers avec un nom de fichier) ou d’un élément Outlook qui constitue la pièce jointe.
Type	Facultatif	Long	Type de la pièce jointe. Il peut s’agir de l’une des constantes OlAttachmentType .
Position	Facultatif	Long	Ce paramètre s’applique uniquement aux messages électroniques au format Texte enrichi : il s’agit de la position où la pièce jointe doit être placée dans le corps du texte du message. La valeur 1 du paramètre Position spécifie que la pièce jointe doit être placée au début du corps du message. Une valeur « n » supérieure au nombre de caractères dans le corps de l’élément de courrier électronique spécifie que la pièce jointe doit être placée à la fin. La valeur 0 masque la pièce jointe.
DisplayName	Facultatif	String	Ce paramètre s’applique uniquement si l’élément de courrier est au format Texte enrichi et si Type a la valeur olByValue : le nom est affiché dans un objet Inspector pour la pièce jointe ou lors de l’affichage des propriétés de la pièce jointe. Si l’élément de courrier électronique est au format texte brut ou HTML, la pièce jointe est affichée à l’aide du nom de fichier indiqué dans le paramètre Source.

Valeur renvoyée

Objet Attachment qui représente la nouvelle pièce jointe.

Remarques

Lorsqu’une pièce jointe est ajoutée à la collection Attachments d’un élément, la propriété Type de la pièce jointe renvoie toujours olOLE (6) jusqu’à ce que l’élément soit enregistré. Pour obtenir des résultats cohérents, enregistrez toujours un élément avant d’ajouter ou de supprimer des objets de la collection Attachments.

Exemple

L’exemple Microsoft Visual Basic/Visual Basic pour Applications (VBA) permet de créer un élément de courrier électronique, d’ajouter une pièce jointe en l’incorporant au début du corps du message et de l’afficher. Pour exécuter cet exemple, veillez à ce que la pièce jointe nommée Test.Doc existe dans le dossier C:\.

Sub AddAttachment() 
 Dim myItem As Outlook.MailItem 
 Dim myAttachments As Outlook.Attachments 
 
 Set myItem = Application.CreateItem(olMailItem) 
 Set myAttachments = myItem.Attachments 
 myAttachments.Add "C:\Test.doc", _ 
 olByValue, 1, "Test" 
 myItem.Display 
End Sub

Voir aussi

Attachments, objet

Joindre un fichier à un élément de courrierJoindre un élément de contact Outlook à un message EmailLimiter la taille d’une pièce jointe à un message outlook EmailModifier une pièce jointe d’un message Email Outlook

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.