Comment ajouter et supprimer des pièces jointes au format PDF

This article was translated from English: Does it need improvement?
Translated
View the article in English

par Jordi Bardia

Les pièces jointes d'un document PDF sont des fichiers ou des données supplémentaires intégrés au fichier PDF lui-même. Il se distingue du contenu normal du PDF, qui comprend le texte, les images et la mise en forme visibles lorsque vous visualisez le PDF. Ces pièces jointes peuvent prendre la forme de divers types de fichiers, notamment des images, des documents, des feuilles de calcul ou d'autres formats. En règle générale, les pièces jointes sont utilisées pour fournir des documents de référence ou des données supplémentaires auxquels les utilisateurs peuvent accéder lorsqu'ils ouvrent le PDF.

Lorsqu'il s'agit de travailler avec des pièces jointes dans IronPDF, le processus est simple et convivial.


Exemple d'ajout de pièce jointe

Pour ajouter un fichier en tant que pièce jointe, chargez-le d'abord dans votre programme en tant que byte[]. La façon la plus simple de le faire est d'utiliser la méthode File.ReadAllBytes. Avec le fichier chargé en octets[], vous pouvez ensuite utiliser la méthode AddAttachment pour ajouter l'objet dans un PDF en tant que pièce jointe, comme suit :

:path=/static-assets/pdf/content-code-examples/how-to/add-remove-attachments-add-attachment.cs
using IronPdf;
using System.IO;

// Import attachment file
byte[] fileData = File.ReadAllBytes(@"path/to/file");

// Open existing PDF
PdfDocument pdf = PdfDocument.FromFile("sample.pdf");

// Add attachment to the PDF
pdf.Attachments.AddAttachment("Example", fileData);

pdf.SaveAs("addAttachment.pdf");

La fonction AddAttachment produit un objet PdfAttachment que nous pouvons conserver pour référence future ou supprimer plus tard si nécessaire.

Après avoir enregistré le PDF, vous pouvez ouvrir la pièce jointe à partir de la barre d'outils d'un visualiseur PDF. L'image ci-dessous montre où trouver cette fonctionnalité dans la visionneuse PDF de Google Chrome :

Aperçu de la pièce jointe

À partir de là, vous pouvez cliquer sur la pièce jointe et l'enregistrer dans votre propre espace de stockage.


Exemple de récupération de pièce jointe

Les pièces jointes dans un PDF peuvent être récupérées sous forme de données binaires en accédant à la propriété Attachments de l'objet PdfDocument. Avec les données binaires, vous pouvez exporter les pièces jointes du PDF dans leurs formats de fichier respectifs.

:path=/static-assets/pdf/content-code-examples/how-to/add-remove-attachments-retrieve-attachment.cs
using IronPdf;
using System.IO;

// Open existing PDF
PdfDocument pdf = PdfDocument.FromFile("addAttachment.pdf");

// Iterate through all attachments
foreach (var attachment in pdf.Attachments)
{
    if (attachment.Name.Contains("Example"))
    {
        // Save byte to file
        File.WriteAllBytes($"{attachment.Name}.doc", attachment.Data);
    }
}

Exemple de suppression d'une pièce jointe

Pour supprimer une pièce jointe, il suffit d'utiliser la fonction RemoveAttachment. Cette méthode nécessite une référence à la pièce jointe, qui peut être récupérée à partir de la propriété Attachments. Nous montrons comment procéder en utilisant le fichier sauvegardé ci-dessus.

:path=/static-assets/pdf/content-code-examples/how-to/add-remove-attachments-remove-attachment.cs
using IronPdf;
using System.Linq;

// Open existing PDF
PdfDocument pdf = PdfDocument.FromFile("addAttachment.pdf");

// Add attachment to the PDF
PdfAttachmentCollection retrieveAttachments = pdf.Attachments;

// Remove attachment from PDF
pdf.Attachments.RemoveAttachment(retrieveAttachments.First());

pdf.SaveAs("removeAttachment.pdf");

Après avoir supprimé la pièce jointe et ouvert le fichier résultant dans une visionneuse PDF, on peut constater que la pièce jointe n'apparaît plus :

Aperçu de la pièce jointe

Jordi related to Exemple de suppression d'une pièce jointe

Jordi Bardia

Ingénieur logiciel

Jordi maîtrise parfaitement Python, C# et C++. Lorsqu'il ne met pas à profit ses compétences chez Iron Software, il se consacre à la programmation de jeux. Partageant des responsabilités en matière de tests de produits, de développement de produits et de recherche, Jordi apporte une valeur ajoutée considérable à l'amélioration continue des produits. Cette expérience variée le stimule et l'engage, et il dit que c'est l'un des aspects qu'il préfère dans son travail chez Iron Software. Jordi a grandi à Miami, en Floride, et a étudié l'informatique et les statistiques à l'université de Floride.