Comment ajouter et supprimer des pièces jointes au format PDF
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.
Comment ajouter et supprimer des pièces jointes au format PDF
- Téléchargez la bibliothèque IronPDF C# depuis NuGet
- Charger un PDF existant ou en créer un nouveau
- Importez le fichier à joindre en tant que byte [] en utilisant la méthode File.ReadAllBytes
- Utilisez la méthode
AddAttachment
pour l'attacher au PDF - Supprimer la pièce jointe du PDF avec la méthode
RemoveAttachment
Exemple d'ajout de pièce jointe
Pour ajouter un fichier en tant que pièce jointe, chargez-le d'abord dans votre programme sous forme de byte []. Le moyen le plus simple de le faire est d'utiliser la méthode File.ReadAllBytes
. Une fois le fichier chargé en tant que byte [], vous pouvez ensuite utiliser la méthode AddAttachment
pour ajouter l'objet dans un PDF comme pièce jointe, de cette manière :
: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 ultérieurement 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 :
À 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, utilisez simplement 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 :