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écharger la bibliothèque IronPDF C# à partir de NuGet
- Charger un PDF existant ou en créer un nouveau
- Importer le fichier à joindre en tant que octet [] utiliser la méthode File.ReadAllBytes
- Utiliser le
Ajouter une pièce jointe
pour l'attacher au PDF - Supprimez la pièce jointe du PDF à l'aide de la fonction
Retirer la pièce jointe
méthode
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 :
À 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 :