Attachments

Cette page décrit l’intégration de fichiers dans un PDF. Il existe deux mécanismes distincts: les pièces jointes au niveau du document, qui sont des fichiers intégrés sans présence visible sur aucune page, et les annotations de pièces jointes ancrées à une page, qui placent une icône cliquable sur une page précise.

Pièces jointes au niveau du document

Document.AddAttachment() intègre bytes sous un name, le réinsérant dans l’arbre de noms des fichiers intégrés du document—l’ajouter de nouveau avec le même nom écrase l’entrée existante. Il renvoie une poignée Attachment. Document.GetAttachments() renvoie chaque pièce jointe au niveau du document sous forme d’un tableau de poignées Attachment, triées par nom, et Document.RemoveAttachment() en supprime une par son nom.

La poignée Attachment expose Name, Description, MimeType, Size, CreationDate et ModDate en tant que propriétés, GetBytes() pour lire le contenu brut du fichier intégré, et GetField()/SetField()/RemoveField() pour un accès de bas niveau aux champs individuels /Filespec. L’option AttachmentOptions transmise à AddAttachment() accepte mimeType, description, compress, creationDate et modDate.

Aucun exemple de code vérifié n’est disponible pour ce API dans l’instantané de connaissances actuel de cette plateforme — consultez le résumé API Reference ci-dessous pour connaître les noms exacts des méthodes et propriétés.

Pièces jointes de fichiers ancrées à la page

Page.AddFileAttachment() intègre un fichier et place une annotation icône /FileAttachment à un rect donné sur une page spécifique, renvoyant un FileAttachmentAnnotation. Contrairement à une pièce jointe du document, celle-ci est visible et cliquable dans un visualiseur PDF. FileAttachmentAnnotation partage les propriétés communes d’annotation (Rect, Color, Contents, Name, Flags, Print, Hidden, Opacity) ainsi que ses propres Icon et FileName, et prend en charge GetBytes() pour lire le contenu intégré et Flatten() afin d’insérer son icône dans le contenu statique de la page.

Conseils et bonnes pratiques

Utilisez une pièce jointe du document (Document.AddAttachment()) pour un fichier qui doit accompagner le PDF sans apparaître sur aucune page; utilisez Page.AddFileAttachment() lorsque le fichier doit être représenté par une icône cliquable à un emplacement précis.
Document.AddAttachment() écrase un fichier joint existant ayant le même name — vérifiez Document.GetAttachments() au préalable si vous devez éviter de le remplacer par inadvertance.
Lisez le contenu d’un fichier joint avec GetBytes() sur les deux types de poignée — la méthode existe à la fois sur Attachment et FileAttachmentAnnotation.

Problèmes courants

Problème	Cause	Correction
Un fichier joint ajouté récemment a remplacé un fichier existant	`Document.AddAttachment()` a été appelé avec un `name` déjà utilisé	Appelez `Document.GetAttachments()` d’abord pour vérifier une collision de nom
Le fichier joint n’affiche aucune icône visible sur la page	`Document.AddAttachment()` a été utilisé, ce qui est au niveau du document et n’a aucune présence sur la page par conception	Utilisez `Page.AddFileAttachment()` à la place pour une icône visible ancrée à la page
`Document.RemoveAttachment()` renvoie `false`	Aucune pièce jointe avec le `name` fourni n’existe dans l’arbre des noms	Confirmez le nom exact via `Document.GetAttachments()` avant de le supprimer

FAQ

Quelle est la différence entre Document.AddAttachment et Page.AddFileAttachment?

Document.AddAttachment() intègre un fichier au niveau du document sans icône visible sur aucune page. Page.AddFileAttachment() intègre un fichier et place une annotation d’icône /FileAttachment cliquable à un emplacement précis sur une page.

Comment lister chaque fichier joint déjà intégré dans un document?

Appelez Document.GetAttachments(), qui renvoie chaque attachement du document sous forme d’un tableau de poignées Attachment triées par nom.

Comment lire le contenu du fichier d’un attachement?

Appelez GetBytes() sur la poignée Attachment (ou FileAttachmentAnnotation) — elle est disponible pour les deux.

Puis-je supprimer un attachement?

Oui — Document.RemoveAttachment(name) supprime un attachement du document par son nom et renvoie si un tel attachement a été trouvé et supprimé.

API Reference Résumé

Classe/Méthode	Description
`Document.AddAttachment()`	Intégrez les octets en tant que pièce jointe nommée au niveau du document
`Document.GetAttachments()`	Lister toutes les pièces jointes du document
`Document.RemoveAttachment()`	Supprimer une pièce jointe du document par son nom
`Attachment`	Gérer plus d’un fichier intégré : `Name`, `Description`, `MimeType`, `Size`, `GetBytes()`
`Page.AddFileAttachment()`	Intégrer un fichier en tant qu’annotation d’icône cliquable ancrée à la page
`FileAttachmentAnnotation`	Le gestionnaire d’annotation de la pièce jointe ancrée à la page ; ajoute `Icon`, `FileName`

Voir aussi

Aspose.PDF — Enterprise Documentation