Passer au contenu du pied de page
UTILISATION D'IRONWORD

Comment créer un fichier DOCX en C#

De nombreuses applications dans l'environnement numérique actuel nécessitent la capacité de générer et de modifier automatiquement des documents. La possibilité de créer et de travailler avec des fichiers DOCX est utile, que vous construisiez un système de reporting d'entreprise, un système de gestion de documents ou que vous automatisiez simplement des activités répétitives. Dans ce tutoriel, nous allons explorer le monde de la génération de documents en C# et examiner les bibliothèques robustes et les méthodes de programmation qui peuvent être utilisées en C# pour créer des fichiers DOCX.

Comment créer un fichier DOCX en C

  1. Installez le package NuGet IronWord.
  2. Récupérez les espaces de noms requis et importez-les depuis IronWord.
  3. Pour générer des fichiers de documents, ajoutez un nouveau TextRun.
  4. Créez un nouveau corps et un nouveau document.
  5. Remplissez le corps du texte avec du contenu (paragraphes, tableaux, etc.).
  6. En utilisant WordDocument, créez un nouveau WordDocument.
  7. L'affectation de l'objet Document à la propriété Document de paragraphe TextRun enregistrera les modifications.

Découvrir le format DOCX

Avant de nous pencher sur le codage, clarifions ce qu'est un fichier DOCX. Microsoft Word et d'autres logiciels de traitement de texte enregistrent les documents au format de fichier DOCX. Il est basé sur la [norme Office Open XML (OOXML)](https://en.wikipedia.org/wiki/Office_Open_XML#:~:text=Office%20Open%20XML%20(also%20informally,initial%20version%20as%20ECMA%2D376.) compressée au format ZIP et basée sur XML. Cela permet d'utiliser les API de Microsoft et d'autres développeurs pour le manipuler par programmation de manière relativement simple.

Mot de Iron

Iron Software a créé la bibliothèque de documents Word connue sous le nom d'IronWord . En matière de manipulation de documents Word dans les applications .NET, IronWord excelle. Pour aider les développeurs .NET C# à inclure la possibilité de créer, lire et modifier des documents Word et DOCX dans leurs programmes, IronWord est une bibliothèque de documents Word robuste.

Caractéristiques d'IronWord

  • Créez et modifiez des fichiers DOC et DOCX : IronWord élimine la nécessité d'installer Office Interop ou Microsoft Word en vous permettant de créer et de modifier des documents Word directement dans vos projets .NET.
  • Ouvrir, modifier un document existant et enregistrer un fichier Word et Docx : la structure du document Word est personnalisable, y compris la configuration de la page (couleur d'arrière-plan, marges, format du papier et orientation).
  • Inclure du texte et des images : grâce à l'API simple, vous pouvez rapidement ajouter du texte et des graphiques à vos documents Word.
  • Compatibilité multiplateforme : IronWord est compatible avec .NET 8, 7, 6, Core, Standard ou Framework, et est conçu pour C#, F# et VB.NET. Il fonctionne dans plusieurs environnements, tels que Docker, iOS, Android, Windows et Linux.
  • Partout dans le monde, des millions d'ingénieurs comptent sur nous : IronWord est un composant de la suite Iron, qui comprend neuf produits de traitement de documents bureautiques basés sur l'API .NET. Les développeurs du monde entier l'utilisent pour créer, consulter et modifier des documents Word.

Pour en savoir plus sur IronWord, consultez cette page .

Créer un nouveau projet dans Visual Studio

Pour lancer l'application Visual Studio, utilisez le menu Fichier et choisissez Fichier. Cliquez sur " Nouveau projet ", puis choisissez " Application console ".

Comment créer un fichier DOCX en C# : Figure 1 - Création d'un nouveau projet

Saisissez le nom du projet dans le champ de texte prévu à cet effet après avoir choisi l'emplacement du fichier. Ensuite, comme indiqué dans l'exemple ci-dessous, cliquez sur le bouton Créer et choisissez le framework .NET requis.

Comment créer un fichier DOCX en C# : Figure 2 - Configuration du nom du projet et du chemin d'accès au fichier

L'organisation du projet Visual Studio dépendra alors de l'application sélectionnée. Pour ajouter du code et créer l'application, il suffit d'ouvrir le fichier program.cs. Vous pouvez utiliser une application web, Windows ou console.

Ensuite, la bibliothèque peut être ajoutée et le code testé.

Installer la bibliothèque IronWord

Utilisation de l'outil Visual Studio : sélectionnez Gestionnaire de packages NuGet dans le menu Outils. Accédez à l'interface du Gestionnaire de paquets pour accéder à la console du terminal de gestion des paquets.

Install-Package IronWord

Après avoir téléchargé et installé le paquet, il peut maintenant être utilisé dans le projet en cours.

Comment créer un fichier DOCX en C# : Figure 3 - Installation d'IronWord avec la console du gestionnaire de paquets

Il existe également la méthode du gestionnaire de paquets. L'installation du paquet directement dans la solution est possible avec l'option Gestionnaire de Paquets NuGet de Visual Studio. L'image ci-dessous vous montre comment lancer le gestionnaire de packages NuGet.

Comment créer un fichier DOCX en C# : Figure 4 - Comment trouver le gestionnaire de packages NuGet

Utilisez la boîte de recherche du site NuGet pour localiser les paquets. Il suffit de rechercher " IronWord " dans le gestionnaire de paquets, comme l'illustre la capture d'écran ci-dessous :

Comment créer un fichier DOCX en C# : Figure 5 - Installation d'IronWord avec le gestionnaire de packages NuGet

La liste des résultats de recherche pertinents est affichée dans l'image ci-dessus. Pour installer le logiciel sur votre machine, il vous suffit de modifier ces paramètres.

Créer un fichier DOCX avec IronWord

Instanciez un objet WordDocument pour créer un nouveau document Word. Pour initialiser le document, vous pouvez utiliser n'importe quel objet qui compose sa structure, comme un paragraphe, un tableau ou une section. Voici une illustration simple dans l'extrait de code suivant :

using IronWord;
using IronWord.Models;

namespace ConsoleApp1
{
    internal class Program
    {
        static void Main(string[] args)
        {
            // Create a text run, which is a portion of the document's text content.
            TextRun textRun = new TextRun("Hello, IronWord!");

            // Create a paragraph and add the text run to it.
            Paragraph paragraph = new Paragraph();
            paragraph.AddTextRun(textRun);

            // Create a new Word document with the paragraph.
            WordDocument doc = new WordDocument(paragraph);

            // Export and save the DOCX file to the specified path.
            doc.SaveAs("document.docx");
        }
    }
}
using IronWord;
using IronWord.Models;

namespace ConsoleApp1
{
    internal class Program
    {
        static void Main(string[] args)
        {
            // Create a text run, which is a portion of the document's text content.
            TextRun textRun = new TextRun("Hello, IronWord!");

            // Create a paragraph and add the text run to it.
            Paragraph paragraph = new Paragraph();
            paragraph.AddTextRun(textRun);

            // Create a new Word document with the paragraph.
            WordDocument doc = new WordDocument(paragraph);

            // Export and save the DOCX file to the specified path.
            doc.SaveAs("document.docx");
        }
    }
}
Imports IronWord
Imports IronWord.Models

Namespace ConsoleApp1
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			' Create a text run, which is a portion of the document's text content.
			Dim textRun As New TextRun("Hello, IronWord!")

			' Create a paragraph and add the text run to it.
			Dim paragraph As New Paragraph()
			paragraph.AddTextRun(textRun)

			' Create a new Word document with the paragraph.
			Dim doc As New WordDocument(paragraph)

			' Export and save the DOCX file to the specified path.
			doc.SaveAs("document.docx")
		End Sub
	End Class
End Namespace
$vbLabelText   $csharpLabel

Nous pouvons ajouter du texte au document grâce à la classe TextRun , qui nous permet de transmettre le texte à l'objet paragraphe grâce à la méthode AddTextRun . Nous créons ensuite un nouvel objet WordDocument pour générer un nouveau fichier DOCX. Enfin, grâce à la méthode SaveAs , nous pouvons enregistrer ce document DOCX à l'emplacement souhaité. Ci-dessous se trouve la sortie générée par le code ci-dessus.

Comment créer un fichier DOCX en C# : Figure 6 - PDF généré par le code précédent

Pour en savoir plus sur le code IronWord, consultez cette page .

Conclusion

Ce guide explique comment utiliser C# pour générer un fichier DOCX. Il aborde les principes fondamentaux du format DOCX, le kit de développement logiciel Open XML (SDK) et la bibliothèque DocX, et fournit des exemples d'utilisation pour générer, modifier et enregistrer des fichiers DOCX.

L'ensemble de ces outils et méthodes vous permettra d'être en excellente position pour gérer diverses tâches de création de documents dans vos projets C#. Apprendre à produire des documents en C# est une compétence utile qui vous aidera dans diverses situations, que ce soit pour automatiser la génération de rapports, développer des systèmes de gestion de documents ou simplement créer des modèles pour les utilisateurs finaux.

Pour les développeurs travaillant avec .NET C#, IronWord est une bibliothèque de documents Word puissante et adaptable. Il permet aux développeurs de lire, d'écrire et de modifier facilement des documents Word (DOCX) dans leurs applications. L'API conviviale d'IronWord facilite le traitement des documents Word. Sans nécessiter l'installation de Microsoft Word ni dépendre d'Office Interop, les développeurs peuvent créer et modifier des fichiers Word directement dans leurs projets .NET. L'ajout de texte, de paragraphes et d'autres éléments aux nouveaux documents Word est simplifié.

IronWord est $799 lors de sa sortie. De plus, les clients qui paient une cotisation annuelle peuvent bénéficier d'une assistance et de mises à jour sur les produits. Moyennant un abonnement, IronWord propose une protection contre la redistribution sans restriction. Pour en savoir plus sur le coût approximatif, consultez cette page . Pour en savoir plus sur Iron Software, cliquez sur ce lien .

Questions Fréquemment Posées

Comment puis-je générer un fichier DOCX en utilisant C# ?

Pour générer un fichier DOCX en utilisant C#, vous pouvez utiliser la bibliothèque IronWord. Commencez par installer le package NuGet IronWord, importez les espaces de noms requis et initiez un objet WordDocument. Vous pouvez ensuite ajouter du contenu en utilisant des méthodes telles que AddTextRun et sauvegarder le document avec la méthode SaveAs.

Quels sont les avantages d'utiliser IronWord pour la génération de fichiers DOCX ?

IronWord offre plusieurs avantages pour la génération de fichiers DOCX, y compris la capacité de créer et modifier des documents sans Microsoft Word, le support multiplateforme, et une API conviviale qui simplifie le processus de création de documents.

Puis-je ajouter des images à un fichier DOCX en utilisant IronWord ?

Oui, IronWord vous permet d'ajouter des images à un fichier DOCX. Vous pouvez utiliser la méthode AddImage pour incorporer des images dans votre document, ce qui peut améliorer l'aspect visuel et la fonctionnalité de vos fichiers DOCX.

Est-il possible de modifier des fichiers DOCX existants avec IronWord ?

Oui, IronWord vous permet de modifier des fichiers DOCX existants. Vous pouvez ouvrir un fichier DOCX en utilisant IronWord, modifier son contenu, sa structure ou son formatage, puis enregistrer les modifications.

IronWord prend-il en charge la génération de documents sur Linux ?

Oui, IronWord prend en charge la génération de documents sur Linux dans le cadre de ses capacités multiplateformes, permettant aux développeurs de créer et manipuler des fichiers DOCX sur divers systèmes d'exploitation, y compris Linux.

Quelles étapes sont nécessaires pour configurer IronWord dans un projet C# ?

La configuration d'IronWord dans un projet C# implique l'installation du package NuGet IronWord via le gestionnaire de packages NuGet, l'importation des espaces de noms nécessaires dans votre code, et l'utilisation de l'API d'IronWord pour réaliser des tâches de création et d'édition de documents.

Comment IronWord gère-t-il la compatibilité des fichiers DOCX ?

IronWord est conçu pour être compatible avec le format DOCX, garantissant que les fichiers créés ou modifiés avec IronWord peuvent être ouverts et utilisés dans Microsoft Word et d'autres traitements de texte compatibles.

Jordi Bardia
Ingénieur logiciel
Jordi est le plus compétent en Python, C# et C++, et lorsqu'il ne met pas à profit ses compétences chez Iron Software, il programme des jeux. Partageant les responsabilités des tests de produit, du développement de produit et de la recherche, Jordi apporte une immense valeur à l'amé...
Lire la suite