De nombreuses applications doivent ajouter du texte à un PDF en .NET pour annoter les documents de manière dynamique. Conholdate.Total for .NET est un SDK complet qui simplifie la manipulation de PDF sur le serveur ou le bureau. Dans ce guide, vous verrez comment installer la bibliothèque, charger un PDF existant, insérer du texte formaté et enregistrer le fichier mis à jour avec un exemple de code complet, prêt à l’exécution.
Exigences pour Ajouter du texte à un PDF en Java
Les développeurs créant des interfaces front‑end basées sur Java ont souvent besoin d’un service .NET capable de modifier les PDF côté serveur. Les exigences typiques comprennent :
- Chargement d’un PDF existant sans perdre le contenu existant.
- Ajout de texte personnalisé à des coordonnées précises, avec une police et une couleur spécifiques.
- Enregistrement du PDF modifié tout en préservant la mise en page et les métadonnées d’origine.
La modification manuelle ou les outils génériques en ligne de commande ne peuvent pas répondre à ces besoins dans un flux de travail automatisé, surtout lorsque l’opération doit être exécutée de manière programmatique pour de nombreux fichiers.
Choisir Conholdate.Total for .NET pour le travail
Conholdate.Total for .NET propose un ensemble complet d’API PDF qui répondent directement aux exigences ci‑dessus. Il peut :
- Ouvrez et modifiez des PDF sans conversion.
- Créez des objets
TextFragmentavec un contrôle complet du style. - Insérez des fragments dans n’importe quelle page à des positions exactes.
- Enregistrez le résultat avec un seul appel de méthode.
Le SDK est fourni sous forme de package NuGet, fonctionne sur tous les runtimes .NET et comprend une documentation détaillée documentation ainsi qu’une référence API complète référence API. Vous pouvez télécharger la dernière version depuis la page de publication.
Guide étape par étape : Ajouter du texte à un PDF en .NET
Voici une démonstration pratique qui reflète le code présenté plus loin dans l’exemple complet.
Installer Conholdate.Total for .NET
Tout d’abord, ajoutez le SDK à votre projet via NuGet.
dotnet add package Conholdate.Total --version 25.10.0
Vous pouvez également obtenir les binaires depuis l’URL de téléchargement.
Charger un document PDF existant
Créez une instance Document pointant vers le PDF source.
using GroupDocs.Pdf;
string inputPath = "input.pdf";
// Load the existing PDF document
using (Document pdfDocument = new Document(inputPath))
{
// further processing...
}
La classe Document fait partie de l’API PDF décrite dans la référence API.
Créer et configurer le fragment de texte
Instanciez un TextFragment, définissez sa position, sa police et sa couleur.
using GroupDocs.Pdf.Contents;
using GroupDocs.Pdf.Contents.Text;
using GroupDocs.Pdf.Contents.Fonts;
// Create a text fragment to insert
TextFragment textFragment = new TextFragment("Added text using Conholdate.Total for .NET");
// Set visual properties
textFragment.Position = new Position(100, 150); // X and Y coordinates in points
textFragment.Font = new Font("Arial", 12);
textFragment.Color = new Color(255, 0, 0); // Red color
Cette étape montre insérer du texte dans un PDF à l’aide de la bibliothèque .NET avec des options de style complètes.
Ajouter un fragment de texte à la page
Sélectionnez la page cible (la première page dans ce cas) et ajoutez le fragment.
// Ensure there is at least one page
Page page = pdfDocument.Pages.Count > 0 ? pdfDocument.Pages[0] : pdfDocument.Pages.Add();
// Add the text fragment to the page
page.Paragraphs.Add(textFragment);
Vous pouvez répéter ce bloc pour ajouter du texte à un fichier PDF en .NET sur plusieurs pages ou positions.
Enregistrer le document PDF modifié
Enfin, écrivez les modifications dans un nouveau fichier.
string outputPath = "output.pdf";
// Save the modified PDF
pdfDocument.Save(outputPath);
Le SDK gère toutes les structures PDF de bas‑niveau, de sorte que le fichier enregistré conserve le contenu original ainsi que la nouvelle annotation.
Code complet d’exemple : Ajouter du texte à un PDF en .NET
L’exemple suivant montre l’ensemble du processus du début à la fin.
using System;
using GroupDocs.Pdf;
using GroupDocs.Pdf.Contents;
using GroupDocs.Pdf.Contents.Text;
using GroupDocs.Pdf.Contents.Fonts;
class Program
{
static void Main()
{
string inputPath = "input.pdf";
string outputPath = "output.pdf";
// Load the existing PDF document
using (Document pdfDocument = new Document(inputPath))
{
// Ensure there is at least one page
Page page = pdfDocument.Pages.Count > 0 ? pdfDocument.Pages[0] : pdfDocument.Pages.Add();
// Create a text fragment to insert
TextFragment textFragment = new TextFragment("Added text using Conholdate.Total for .NET");
// Set visual properties
textFragment.Position = new Position(100, 150); // X and Y coordinates in points
textFragment.Font = new Font("Arial", 12);
textFragment.Color = new Color(255, 0, 0); // Red color
// Add the text fragment to the page
page.Paragraphs.Add(textFragment);
// Save the modified PDF
pdfDocument.Save(outputPath);
}
Console.WriteLine($"Text successfully added. Output saved to '{outputPath}'.");
}
}
Remarque : Cet exemple de code démontre la fonctionnalité principale. Avant de l’utiliser dans votre projet, assurez-vous de mettre à jour tous les chemins de fichiers et les valeurs de configuration pour qu’ils correspondent à votre environnement réel, vérifiez que toutes les dépendances requises sont correctement installées et testez soigneusement dans votre environnement de développement. Si vous rencontrez des problèmes, veuillez consulter la documentation officielle ou contacter l’équipe d’assistance pour obtenir de l’aide.
Conclusion
Ajouter du texte à un PDF sous .NET est simple grâce aux fonctionnalités puissantes de Conholdate.Total for .NET. En suivant les étapes ci‑dessus, vous pouvez charger un document, créer un TextFragment stylisé, le placer avec précision et enregistrer le résultat en quelques lignes de code seulement. N’oubliez pas d’appliquer une licence valide pour les déploiements en production ; vous pouvez obtenir une licence temporaire depuis la page de licence et consulter les options de tarification sur la page de tarification. Avec cette base, vous pouvez étendre l’approche aux annotations multilignes, à l’insertion de données dynamiques ou au traitement par lots de PDF.
FAQ
Comment insérer du texte dans un PDF à l’aide de la bibliothèque .NET ?
Utilisez la classe TextFragment de l’API PDF, définissez son Position, son Font et son Color, puis ajoutez‑la à la collection Paragraphs d’une page. Le flux complet est illustré dans l’exemple de code ci‑dessus.
Puis-je écrire du texte dans un PDF existant avec .NET sans écraser le reste du contenu ?
Oui. Le SDK modifie le PDF en place, en préservant les pages, images et annotations existantes tout en ajoutant de nouveaux fragments de texte.
Quelle est la meilleure façon d’ajouter du texte à un fichier PDF en .NET pour plusieurs pages ?
Parcourez la collection Pages, créez un TextFragment pour chaque page, configurez sa position et ajoutez‑le aux Paragraphs de la page. Cette approche s’adapte à n’importe quel nombre de pages.