IRONSOFTWAREHOME

Comment ajouter et supprimer des pièces jointes PDF en C# ; avec IronPDF

Curtis Chau
Curtis Chau
Updated: 22 avril 2026

IronPDF vous permet d'ajouter, de récupérer et de supprimer par programmation des pièces jointes dans des documents PDF à l'aide de méthodes C# simples telles que AddAttachment() et RemoveAttachment(), ce qui vous permet d'intégrer des fichiers supplémentaires directement dans vos PDF.

Les pièces jointes dans un document PDF font référence à des fichiers ou des données supplémentaires intégrés dans le fichier PDF lui-même. Cela est distinct du contenu régulier du PDF, qui inclut du texte visible, des images et du formatage lorsque vous visualisez le PDF. Ces pièces jointes peuvent prendre la forme de divers types de fichiers, y compris 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 matériaux de référence supplémentaires ou des données complémentaires que les utilisateurs peuvent consulter lorsqu'ils ouvrent le PDF. Cette capacité est particulièrement utile pour créer des rapports PDF complets ou lorsque vous devez fusionner plusieurs PDF avec de la documentation à l'appui.

Démarrage rapide : Ajouter des pièces jointes à un PDF

Ajoutez des pièces jointes à vos documents PDF à l'aide d'IronPDF. Ce rapide exemple démontre comment intégrer un fichier en tant que pièce jointe dans un PDF. Chargez votre PDF existant, utilisez la méthode AddAttachment, puis enregistrez le document mis à jour. Ce processus permet de s'assurer que les documents supplémentaires sont inclus dans le PDF, ce qui les rend accessibles directement à partir de n'importe quelle visionneuse PDF.

  1. 1Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. 2Copiez et exécutez cet extrait de code.

    var pdf = IronPdf.PdfDocument.FromFile("example.pdf");
    pdf.Attachments.AddAttachment("file.txt", System.IO.File.ReadAllBytes("file.txt"));
    pdf.SaveAs("updated.pdf");
    C#
  3. 3Déployez pour tester sur votre environnement de production.

    Commencez à utiliser IronPDF dans votre projet dès aujourd'hui avec un essai gratuit
    arrow pointer

Comment ajouter un fichier en pièce jointe à un PDF?

Pour ajouter un fichier en pièce jointe, chargez-le d'abord en tant que byte[]. La manière la plus simple d'y parvenir est d'utiliser la méthode File.ReadAllBytes. Une fois le fichier chargé en tant que byte[], utilisez la méthode AddAttachment pour ajouter l'objet dans un PDF en tant que pièce jointe :

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 génère un objet PdfAttachment que vous pouvez conserver pour référence ultérieure ou supprimer plus tard si nécessaire. Cette approche est similaire à la manière dont vous ajouteriez des images aux PDF ou géreriez d'autres ressources PDF.

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

Visionneuse PDF affichant le document " Hello World " avec commandes de navigation et panneau latéral.

Vous pouvez ensuite cliquer sur la pièce jointe et l'enregistrer dans votre espace de stockage.

Quels types de fichiers puis-je joindre à un PDF ?

IronPDF permet de joindre pratiquement n'importe quel type de fichier aux documents PDF. Les types de pièces jointes les plus courants sont les suivants :

  • Documents Office (DOCX, XLSX, PPTX)
  • Images (JPG, PNG, GIF, SVG)
  • Fichiers texte (TXT, CSV, XML)
  • Archives (ZIP, RAR)
  • Autres PDF

Le système de pièces jointes fonctionne avec des données binaires, de sorte que tout fichier pouvant être lu sous forme d'octets peut être joint. Lorsque vous travaillez avec des types de documents spécifiques, vous pouvez également envisager les fonctions de conversion intégrées d'IronPDF, telles que convertir DOCX en PDF ou convertir des images en PDF.

Où apparaissent les pièces jointes dans les visionneurs de PDF ?

Les différentes visionneuses PDF affichent les pièces jointes à des endroits différents :

  • Adobe Acrobat : Affiche une icône de trombone dans le volet de navigation
  • Visionneur PDF Chrome : Affiche les pièces jointes dans la barre latérale gauche lorsqu'on clique dessus
  • Firefox PDF Viewer : Affiche les pièces jointes dans un panneau dédié
  • Microsoft Edge : Semblable à Chrome, avec un affichage des pièces jointes dans la barre latérale

La plupart des visionneuses PDF modernes prennent en charge les pièces jointes, bien que l'interface puisse varier légèrement d'une application à l'autre.

Qu'arrive-t-il à l'objet PdfAttachment après son ajout ?

Lorsque vous appelez AddAttachment(), IronPDF crée un objet PdfAttachment qui contient :

  • Nom : Le nom d'affichage de la pièce jointe
  • Données : Le contenu binaire du fichier joint
  • Description : Métadonnées facultatives sur la pièce jointe

Cet objet est ajouté à la collection interne de pièces jointes du PDF et reste accessible via la propriété Attachments jusqu'à ce qu'il soit explicitement supprimé.

Attachments

Comment récupérer les pièces jointes d'un PDF existant?

Les pièces jointes d'un fichier 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.

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);
    }
}

Ce processus est particulièrement utile lorsque vous devez extraire du contenu à partir de PDF ou traiter des documents joints de manière programmatique.

Comment accéder à plusieurs pièces jointes dans un PDF?

La propriété Attachments renvoie une collection que vous pouvez parcourir ou interroger à l'aide de LINQ :

// Get all attachments as a list
var allAttachments = pdf.Attachments.ToList();

// Filter attachments by size (e.g., files larger than 1MB)
var largeAttachments = pdf.Attachments
    .Where(a => a.Data.Length > 1024 * 1024)
    .ToList();

// Find specific attachment by exact name
var specificAttachment = pdf.Attachments
    .FirstOrDefault(a => a.Name == "report.xlsx");

Quelles sont les propriétés disponibles pour les pièces jointes récupérées ?

Chaque objet PdfAttachment fournit :

  • Name : Le nom d'affichage de la pièce jointe
  • Data : Contenu binaire sous forme de tableau d'octets
  • Description : Métadonnées de description facultatives (si définies)

Vous pouvez utiliser ces propriétés pour identifier, filtrer et traiter les pièces jointes en fonction de vos besoins.

Comment filtrer les pièces jointes par nom ou par type?

Les pièces jointes étant stockées avec leur nom d'affichage, vous pouvez les filtrer à l'aide d'opérations sur les chaînes de caractères :

// Filter by file extension (assuming names include extensions)
var imageAttachments = pdf.Attachments
    .Where(a => a.Name.EndsWith(".jpg") || 
                a.Name.EndsWith(".png") || 
                a.Name.EndsWith(".gif"))
    .ToList();

// Filter by name pattern
var reportsOnly = pdf.Attachments
    .Where(a => a.Name.StartsWith("Report_"))
    .ToList();

Ma bibliothèque préférée de ce genre est IronPDF. Elle permet une manipulation rapide et efficace des fichiers PDF. Elle dispose également de nombreuses fonctionnalités précieuses, comme l'exportation au format PDF/A et la signature numérique des documents PDF.

Milan Jovanovic

Microsoft MVP

Voir l'étude de cas

IronOCR signifie que nous pouvons économiser 40 000 $ par an grâce au traitement manuel, tout en améliorant la productivité et en libérant des ressources pour des tâches à fort impact. Je le recommande vivement.

Brent Matzelle

Directeur technique, OPYN

Voir l'étude de cas

Iron Suite joue un rôle crucial dans nos opérations. Ce sont des outils qui augmentent l'efficacité de l'entreprise, y compris la création de plans d'étage et l'amélioration de la gestion des stocks.

David Jones

Ingénieur logiciel principal, Agorus Build

Voir l'étude de cas

Comment supprimer les pièces jointes d'un PDF?

Pour supprimer une pièce jointe, utilisez 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. Voici comment procéder en utilisant le fichier enregistré ci-dessus :

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 retiré la pièce jointe et ouvert le fichier résultant dans un lecteur PDF, vous verrez que la pièce jointe n'apparaît plus :

Visionneuse PDF avec panneau des pièces jointes ouvert, affichant le document " Hello World " et le bouton " Afficher les pièces jointes ".

Que se passe-t-il lorsque je supprime une pièce jointe?

Lorsque vous supprimez une pièce jointe :

  1. Les données de la pièce jointe sont entièrement supprimées du fichier PDF
  2. La taille du fichier diminue d'environ la taille de la pièce jointe supprimée
  3. Toutes les références à cette pièce jointe dans la structure du PDF sont nettoyées
  4. La modification est permanente une fois que vous avez enregistré le PDF

Cette opération est similaire à d'autres opérations de modification de PDF telles que suppression de pages ou rédaction de contenu.

Peut-on supprimer plusieurs pièces jointes à la fois ?

Oui, vous pouvez supprimer plusieurs pièces jointes en une seule opération. Voici un exemple :

// Remove all attachments that match a pattern
var attachmentsToRemove = pdf.Attachments
    .Where(a => a.Name.StartsWith("temp_"))
    .ToList();

foreach (var attachment in attachmentsToRemove)
{
    pdf.Attachments.RemoveAttachment(attachment);
}

// Or remove all attachments at once
while (pdf.Attachments.Count > 0)
{
    pdf.Attachments.RemoveAttachment(pdf.Attachments.First());
}

Comment vérifier qu'une pièce jointe a bien été supprimée?

Vous pouvez vérifier la suppression des pièces jointes de plusieurs façons :

// Check the attachment count
int attachmentCountBefore = pdf.Attachments.Count;
pdf.Attachments.RemoveAttachment(targetAttachment);
int attachmentCountAfter = pdf.Attachments.Count;

// Verify the count decreased
if (attachmentCountAfter < attachmentCountBefore)
{
    Console.WriteLine("Attachment successfully removed");
}

// Check if specific attachment exists
bool attachmentExists = pdf.Attachments
    .Any(a => a.Name == "specificFile.txt");

Bonnes pratiques pour les pièces jointes PDF

Lorsque vous travaillez avec des pièces jointes PDF dans IronPDF, tenez compte de ces meilleures pratiques :

  1. Gestion de la taille des fichiers : Soyez attentif à la taille des pièces jointes, car elles augmentent directement la taille du fichier PDF
  2. Convention de nommage : Utilisez des noms clairs et descriptifs pour les pièces jointes afin d'aider les utilisateurs à les identifier
  3. Considérations de sécurité : Lorsque vous gérez des pièces jointes sensibles, envisagez d'appliquer des mots de passe et permissions PDF
  4. Performance : Pour les pièces jointes volumineuses ou les nombreux fichiers, envisagez d'utiliser des opérations asynchrones pour maintenir la réactivité de l'application

Prêt à voir ce que vous pouvez faire d'autre? Consultez notre page de tutoriel ici : Organiser les PDFs

Questions Fréquemment Posées

Comment ajouter des pièces jointes à un PDF de manière programmatique en C# ?

IronPDF propose une méthode simple, AddAttachment(), pour intégrer des fichiers dans les PDF. Tout d'abord, chargez votre fichier sous forme de tableau d'octets à l'aide de File.ReadAllBytes(), puis utilisez la méthode AddAttachment sur votre objet PdfDocument. La méthode prend le nom du fichier et le tableau d'octets comme paramètres.

Quels types de fichiers peuvent être joints aux PDF ?

IronPDF vous permet de joindre différents types de fichiers aux PDF, notamment des images, des documents, des feuilles de calcul et d'autres formats. Ces pièces jointes sont intégrées directement dans le fichier PDF et sont accessibles via le panneau des pièces jointes de n'importe quelle visionneuse PDF standard.

Comment charger un PDF existant pour y ajouter des pièces jointes ?

Vous pouvez charger un PDF existant à l'aide de la méthode IronPDF PdfDocument.FromFile(). Une fois chargé, vous pouvez utiliser la propriété Attachments pour gérer les pièces jointes, y compris l'ajout de nouvelles pièces jointes avec AddAttachment() ou la suppression de pièces jointes existantes.

Quelle est la différence entre le contenu d'un fichier PDF et les pièces jointes d'un fichier PDF ?

Le contenu d'un PDF comprend le texte visible, les images et la mise en forme que vous voyez lorsque vous consultez le PDF. Les pièces jointes sont des fichiers distincts intégrés au PDF qui n'apparaissent pas dans la vue principale du document. Avec IronPDF, les pièces jointes sont accessibles via le panneau des pièces jointes de la visionneuse PDF et servent de matériel supplémentaire.

Comment supprimer les pièces jointes d'un PDF ?

IronPDF fournit une méthode RemoveAttachment() pour supprimer par programme les fichiers incorporés dans les PDF. La fonction AddAttachment renvoie un objet PdfAttachment auquel vous pouvez faire référence ultérieurement pour les opérations de suppression.

Où les utilisateurs peuvent-ils trouver des pièces jointes dans une visionneuse PDF ?

Après avoir utilisé IronPDF pour ajouter des pièces jointes, les utilisateurs peuvent y accéder via la barre d'outils de la visionneuse PDF. La plupart des visionneuses PDF, y compris la visionneuse intégrée de Google Chrome, affichent une icône de pièce jointe ou un panneau où les fichiers incorporés peuvent être ouverts ou enregistrés.

Is it possible to filter PDF attachments by type or name in IronPDF?

Yes, you can filter attachments using the `Attachments` collection based on file extensions or specific name patterns.

What are the best practices for managing PDF attachments in IronPDF?

Some best practices include managing file sizes, using descriptive naming conventions, securing sensitive content with passwords, and leveraging asynchronous operations for better performance.

How can I verify if an attachment was successfully removed?

You can verify attachment removal by checking the number of attachments before and after removal or confirming the absence of the specific attachment by name in the `Attachments` collection.

What happens to the PDF file size when attachments are removed using IronPDF?

Removing attachments with IronPDF reduces the file size roughly by the size of the attachment, as the attachment data is completely removed from the PDF file.

Curtis Chau
Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.

...
Lire la suite

Prêt à commencer ?

Nuget Downloads 21,105,021Version :2026.9vient de sortir

Obtenez votre GRATUIT

Clé d'essai de 30 jours instantanément.

bullet_checkedAucune carte de crédit ou création de compte requise
bullet_testTester en production
sans filigranes
bullet_calendarProduit entièrement fonctionnel
pendant 30 jours
bullet_supportSupport technique 24/5
pendant l'essai
Obtenez votre clé d'essai 30 jours gratuitement.
Aucune carte de crédit ou création de compte requise
Bibliothèque C# NuGet pour PDF
Installer avec NuGet

Version : 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. Dans l'explorateur de solutions, faites un clic droit sur Références, Gestion des packages NuGet
  2. Sélectionnez Parcourir et recherchez « IronPDF »
  3. Sélectionnez le package et installez
C# PDF DLL
Télécharger DLL

Version : 2026.9

ou téléchargez l'installateur Windows ici.

  1. Téléchargez et décompressez IronPDF à un emplacement tel que ~/Libs dans votre répertoire de solution
  2. Dans l'explorateur de solutions Visual Studio, faites un clic droit sur Références. Sélectionnez Parcourir, « IronPDF.dll »

Licences à partir de 749 $

Vous avez une question ? Contactez notre équipe de développement.

Key in blue circle

Obtenez votre clé d'essai de 30 jours instantanément.

Your trial license will be sent to your email address

Aucune restriction. 100 % débloqué. Pas de carte bancaire.

OR
bullet_checkedAucune carte de crédit ou création de compte requiseAucune restriction. 100 % débloqué. Pas de carte bancaire.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried Iron Suite
Réservez votre Démonstration en direct gratuite
Booking Badge

De confiance par des millions d'ingénieurs dans le monde entier

Logos des clients d'Iron Software
Obtenez Votre Consultation sans Engagement
Remplissez le formulaire ci-dessous ou envoyez un email à sales@ironsoftware.com
Vos informations seront toujours gardées confidentielles.
De confiance par des millions d'ingénieurs dans le monde entier
Logos des clients d'Iron Software
Obtenez votre clé d'essai 30 jours gratuitement.
Aucune carte de crédit ou création de compte requise
Bibliothèque C# NuGet pour PDF
Installer avec NuGet

Version : 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. Dans l'explorateur de solutions, faites un clic droit sur Références, Gestion des packages NuGet
  2. Sélectionnez Parcourir et recherchez « IronPDF »
  3. Sélectionnez le package et installez
C# PDF DLL
Télécharger DLL

Version : 2026.9

ou téléchargez l'installateur Windows ici.

  1. Téléchargez et décompressez IronPDF à un emplacement tel que ~/Libs dans votre répertoire de solution
  2. Dans l'explorateur de solutions Visual Studio, faites un clic droit sur Références. Sélectionnez Parcourir, « IronPDF.dll »

Licences à partir de 749 $