Comment enregistrer et éditer l'historique des révisions PDF en C#

Comment sauvegarder et éditer l'historique des révisions d'un PDF en C#35;

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

IronPDF permet aux développeurs C# de suivre et de gérer les modifications apportées aux documents PDF au fil du temps grâce à l'historique des révisions. Enregistrez les itérations du document avec la méthode SaveAsRevision et revenez aux versions précédentes avec GetRevision lorsque vous collaborez sur des documents.

Démarrage rapide : Enregistrer les révisions de PDF avec IronPDF)

Gérez et enregistrez des révisions de PDF à l'aide d'IronPDF dans vos applications C#. Ce guide présente l'enregistrement des versions de documents avec la méthode SaveAsRevision d'IronPDF pour le suivi et la gestion des modifications apportées aux PDF. Chargez un fichier PDF et enregistrez-le en tant que révision distincte pour archiver toutes les modifications.

Nuget IconCommencez dès maintenant à créer des PDF avec NuGet :

  1. Installez IronPDF avec le gestionnaire de packages NuGet

    PM > Install-Package IronPdf

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

    var pdf = IronPdf.PdfDocument.FromFile("example.pdf");
    pdf.SaveAsRevision("revision1.pdf");
  3. Déployez pour tester sur votre environnement de production.

    Commencez à utiliser IronPDF dans votre projet dès aujourd'hui grâce à un essai gratuit.
    arrow pointer

as-heading:3(Flux de travail minimal (5 étapes)

  1. Téléchargez la bibliothèque C# pour enregistrer et modifier l'historique de révision d'un PDF avec IronPDF
  2. Utilisez la méthode SaveAsRevision pour enregistrer les versions PDF.
  3. Récupérez les versions PDF à l'aide de la méthode GetRevision.
  4. Accédez à la propriété RevisionCount pour connaître le nombre de révisions.
  5. Enregistrez le PDF final à l'aide de SaveAs.

Comment sauvegarder et signer une révision d'itération de PDF?

<TODO : Ajouter une image ici -->

Dans l'exemple suivant, nous ouvrons un fichier PDF, y apportons diverses modifications, puis le signons avant de l'enregistrer. En ce qui concerne les autorisations de signature, nous n'autorisons que le remplissage de formulaires pour les éditions futures ; sinon, la signature sera invalidée pour toute autre modification.

Nous appelons ensuite SaveAsRevision pour enregistrer la révision dans l'historique et sauvegarder notre nouveau document sur le disque. Cette approche est utile lors de la mise en œuvre de flux de signatures numériques dans des applications d'entreprise où l'intégrité des documents et les pistes d'audit sont essentielles.

Veuillez noterPour améliorer les performances de l'exportation PDF, nous avons défini l'option TrackChanges sur false. Cette option doit être définie sur true pour utiliser la fonction d'enregistrement incrémentiel.

:path=/static-assets/pdf/content-code-examples/how-to/signing-revision.cs
using IronPdf;
using IronPdf.Rendering;

// Import PDF and enable TrackChanges
PdfDocument pdf = PdfDocument.FromFile("annual_census.pdf", TrackChanges: ChangeTrackingModes.EnableChangeTracking);
// ... various edits ...
pdf.SignWithFile("/assets/IronSignature.p12", "password", null, IronPdf.Signing.SignaturePermissions.AdditionalSignaturesAndFormFillingAllowed);

PdfDocument pdfWithRevision = pdf.SaveAsRevision();

pdfWithRevision.SaveAs("annual_census_2.pdf");
$vbLabelText   $csharpLabel

Le paramètre ChangeTrackingModes.EnableChangeTracking est essentiel pour maintenir une piste d'audit complète. Lorsqu'elle est activée, IronPDF conserve toutes les modifications apportées au document sous forme de couches distinctes, ce qui permet de naviguer dans l'historique du document. Cette fonctionnalité s'intègre à Sécurité et permissions des PDF pour garantir que seuls les utilisateurs autorisés peuvent accéder à des révisions spécifiques.

Pourquoi la compréhension de la sauvegarde incrémentale est-elle importante pour les signatures ?

<TODO : Ajouter une image ici -->

Alors que certaines visionneuses comme le navigateur Chrome n'affichent qu'une seule version, les fichiers PDF peuvent stocker les versions précédentes du document, à l'instar de l'historique des livraisons de Git. Vous verrez cela dans les visionneurs de PDF avancés tels qu'Adobe Acrobat. La compréhension de ce mécanisme d'enregistrement incrémentiel est cruciale lorsqu'on travaille avec des PDF signés car chaque signature s'applique à un état spécifique du document.

En ce qui concerne les signatures PDF, sachez que la signature d'un PDF s'applique à l'itération actuelle du PDF. Votre PDF peut comporter des signatures pour des itérations plus anciennes ou des versions non signées. Nous pouvons visualiser un exemple comme ceci :

Itération du document PDF Certificat A Certificat B Certificat C# Certificat D
0 (première sauvegarde)
1
2
3
(édition de champs de formulaire uniquement)

(édition de champs de formulaire uniquement)
4 (seuls les champs du formulaire ont été édités)
5
(aucune autre modification n'est autorisée)

(aucune autre modification n'est autorisée)

(aucune autre modification n'est autorisée)

Ci-dessus, nous avons un document qui a fait l'objet de 6 itérations. Ce document peut être passé entre les départements d'une entreprise avec approbation jusqu'à être finalisé lors de l'itération 3. Dans cette itération, tant Personne A que Personne B ont signé le document avec la permission "Form Field Edits Only" définie. Cela signifie qu'il est permis de remplir les champs du formulaire dans le document PDF, mais que toute autre modification du document entraînera l'invalidation de leurs signatures.

Dans l'exemple ci-dessus, supposons que la personne C# ait rempli le formulaire et l'ait renvoyé aux personnes A, B et D, qui ont toutes signé le document une dernière fois avec l'autorisation "Aucune modification autorisée". Étant donné qu'aucune action d'invalidation n'a été entreprise dans ce document, lorsque nous exécutons la méthode de signature d'IronPDF, nous obtenons true.

Cette approche d'économie progressive est précieuse lorsqu'elle est associée à des fonctions de sécurité PDF complètes, car elle garantit que chaque signature reste valide uniquement pour l'état spécifique du document auquel elle a été appliquée. Cela permet d'éviter les modifications non autorisées tout en conservant une piste d'audit complète de tous les changements.

Comment revenir à une ancienne révision?

<TODO : Ajouter une image ici -->

Pour revenir à une révision précédente d'un PDF, utilisez la méthode GetRevision. Cela oubliera toutes les modifications apportées depuis cette révision, y compris les nouvelles signatures. Cette fonctionnalité est essentielle lorsqu'il s'agit de récupérer des modifications non souhaitées ou d'examiner l'évolution du document au fil du temps.

:path=/static-assets/pdf/content-code-examples/how-to/signing-revert-revision.cs
using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("report.pdf");

int versions = pdf.RevisionCount; // total revisions

PdfDocument rolledBackPdf = pdf.GetRevision(2);
rolledBackPdf.SaveAs("report-draft.pdf");
$vbLabelText   $csharpLabel

La méthode GetRevision crée une nouvelle instance de document PDF contenant uniquement le contenu jusqu'au numéro de révision spécifié. Cette traduction est utile dans les cas où :

  • Vous devez comparer différentes versions d'un document
  • Une signature a été invalidée en raison de modifications non autorisées
  • Vous souhaitez vous éloigner d'une version antérieure pour un flux de travail d'approbation différent
  • Vous devez démontrer la conformité en montrant l'état du document à un moment précis

Lorsque vous travaillez avec des révisions, le retour en arrière n'affecte pas le fichier PDF d'origine - il crée une nouvelle instance de document. Cette approche permet de préserver l'intégrité des données tout en offrant une certaine souplesse dans la gestion des versions du document. Pour des techniques de manipulation de PDF plus avancées, explorez les capacités d'édition complètes d'IronPDF.

Bonnes pratiques pour la gestion des révisions de PDF

Lorsque vous mettez en œuvre l'historique des révisions dans vos applications, tenez compte de ces bonnes pratiques :

  1. Toujours activer le suivi des modifications : Définissez TrackChanges : ChangeTrackingModes.EnableChangeTracking lors de l'ouverture de PDF nécessitant un historique des révisions.

  2. Documentez votre stratégie de révision : Conservez une documentation claire indiquant quand et pourquoi les révisions sont sauvegardées, en particulier dans les environnements multi-utilisateurs.

  3. Mettre en place des contrôles d'accès : Combinez l'historique des révisions avec les permissions et mots de passe IronPDF pour vous assurer que seuls les utilisateurs autorisés peuvent créer ou accéder à des révisions spécifiques.

  4. Exportations régulières : Périodiquement, exporter les révisions importantes vers des fichiers séparés pour un archivage à long terme.

  5. Tester la compatibilité des signatures : Testez la façon dont les différentes autorisations de signature interagissent avec votre flux de travail de révision afin d'éviter les invalidations inattendues.

En suivant ces pratiques et en exploitant les fonctionnalités de gestion des révisions d'IronPDF, vous pouvez créer des flux de documents sophistiqués qui conservent des pistes d'audit complètes tout en garantissant l'intégrité des documents tout au long du processus de collaboration. Pour plus d'informations sur la mise en œuvre de ces fonctionnalités dans vos applications, consultez la documentation complète d'IronPDF ou explorez les options de licence pour les besoins de votre entreprise.

Questions Fréquemment Posées

Comment enregistrer des révisions de PDF en C# ?

Vous pouvez enregistrer des révisions de PDF en C# à l'aide de la méthode SaveAsRevision d'IronPDF. Il vous suffit de charger votre document PDF et d'appeler pdf.SaveAsRevision('revision1.pdf') pour créer une version sauvegardée qui suit toutes les modifications apportées au document.

À quoi sert le suivi de l'historique des révisions des PDF ?

La fonction d'historique des révisions d'IronPDF permet aux développeurs de suivre les modifications apportées aux documents au fil du temps, ce qui permet de mettre en place des flux de travail collaboratifs dans lesquels vous pouvez revenir aux versions précédentes à l'aide de la méthode GetRevision. Cette fonction est essentielle pour maintenir des pistes d'audit dans les applications d'entreprise.

Comment activer le suivi des modifications pour les sauvegardes incrémentielles ?

Pour activer le suivi des modifications dans IronPDF, définissez l'option TrackChanges sur true et utilisez le paramètre ChangeTrackingModes.EnableChangeTracking. Cela permet de conserver toutes les modifications du document sous forme de couches distinctes, ce qui permet de naviguer dans l'historique complet du document.

Puis-je signer un PDF et conserver l'historique de ses révisions ?

Oui, IronPDF vous permet de signer des PDF tout en conservant l'historique des révisions. Lorsque vous signez un document, la signature s'applique à l'itération en cours. Vous pouvez définir des autorisations spécifiques, comme le remplissage de formulaires uniquement, afin d'éviter que la signature ne soit invalidée par des modifications ultérieures.

Comment récupérer les versions précédentes du PDF ?

IronPDF propose la méthode GetRevision pour récupérer les versions précédentes d'un document PDF. Vous pouvez également utiliser la propriété RevisionCount pour déterminer combien de révisions existent dans l'historique du document.

Qu'advient-il des signatures lorsque j'enregistre une nouvelle révision ?

Lorsque l'on utilise la méthode SaveAsRevision d'IronPDF après avoir signé un document, la signature reste valable pour cette révision spécifique. Cependant, toute modification dépassant les permissions autorisées (comme le remplissage de formulaires) invalidera la signature, garantissant ainsi l'intégrité du document.

L'historique des révisions est-il visible dans tous les visionneurs de PDF ?

Bien qu'IronPDF enregistre un historique complet des révisions similaire aux commits Git, tous les visionneurs de PDF n'affichent pas ces informations. Les visionneuses de base comme Chrome n'affichent que la version actuelle, tandis que les visionneuses avancées comme Adobe Acrobat peuvent afficher l'historique complet des révisions.

Comment l'enregistrement incrémentiel améliore-t-il les performances des PDF ?

La fonction d'enregistrement incrémentiel d'IronPDF améliore les performances d'exportation en n'enregistrant que les modifications au lieu de réécrire l'intégralité du document. Vous pouvez optimiser les performances en réglant TrackChanges sur false lorsque le suivi des révisions n'est pas nécessaire, bien que cela doive être activé pour les sauvegardes incrémentielles.

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 ...

Lire la suite
Prêt à commencer?
Nuget Téléchargements 17,012,929 | Version : 2025.12 vient de sortir