UTILISATION D'IRONWORD

Comment créer un fichier DOCX en C#

Publié avril 3, 2024
Partager:

Introduction

Dans l'environnement numérique d'aujourd'hui, de nombreuses applications nécessitent la capacité de générer et de modifier des documents automatiquement. La possibilité de créer et de travailler avec des fichiers DOCX est utile, qu'il s'agisse de créer un système de reporting au niveau de l'entreprise, un système de gestion des documents ou simplement d'automatiser des activités répétitives. Dans ce tutoriel, nous allons plonger dans le monde de la génération de documents en C# et examiner les solides bibliothèques et 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 paquetage NuGet IronWord.

  2. Prenez les espaces de noms requis et importez-les de l'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. Remplir le corps avec du contenu (paragraphes, tableaux, etc.).

  6. À l'aide de WordDocument, créez un nouveau document Word.

  7. L'affectation de l'objet Document à la propriété TextRun, Paragraph Document permet de sauvegarder les modifications.

Connaître le format DOCX

Avant de nous plonger dans le codage, précisons ce qu'est un fichier DOCX. Microsoft Word et d'autres programmes de traitement de texte enregistrent les documents au format DOCX. Il est basé sur le système ZIP-compressé basé sur XML [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.). Cela permet d'utiliser les API de Microsoft et d'autres développeurs pour le manipuler de manière programmatique relativement simplement.

IronWord

Iron Software a créé la bibliothèque de documents Word connue sous le nom de IronWord. Lorsqu'il s'agit d'offrir de solides capacités de manipulation de documents Word dans les applications .NET. IronWord brille, pour aider les développeurs C# .NET à inclure la capacité 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 documents DOC et DOCX : IronWord élimine la nécessité de l'interopérabilité avec Office ou de l'installation de Microsoft Word en vous permettant de créer et d'éditer 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 des pages (la couleur d'arrière-plan, les marges, la taille du papier et l'orientation).
  • Inclure des mots et des images : Grâce à l'API simple, vous pouvez rapidement ajouter du texte et des graphiques à vos documents Word.
  • Prise en charge 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.
  • Dans le monde entier, des millions d'ingénieurs nous font confiance : IronWord est un composant de la Suite Iron, qui se compose de neuf produits de documents bureautiques API .NET. Les développeurs l'utilisent dans le monde entier pour créer, afficher et modifier des documents Word.

    Pour en savoir plus sur la référence IronWord ici.

Création d'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 le montre 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épend alors de l'application sélectionnée. Pour ajouter du code et construire l'application, il suffit d'ouvrir le fichier program.cs. L'application Internet, Windows ou la console peuvent toutes être utilisées.

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 NuGet Package Manager dans le menu Outils. Entrez dans 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'option NuGet Package Manager de Visual Studio permet d'installer le paquet directement dans la solution. L'image ci-dessous montre comment lancer le gestionnaire de paquets NuGet.

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

Utilisez la boîte de recherche du site web de 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 paquets 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 suffit d'ajuster ces paramètres.

Créer un fichier DOCX avec IronWord

Instanciation d'un objet WordDocument pour démarrer un nouveau document Word. Pour initialiser le document, vous pouvez utiliser n'importe quel objet qui compose la structure du document, 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
            TextRun textRun = new TextRun("Hello, IronPdf");
            Paragraph paragraph = new Paragraph();
            paragraph.AddTextRun(textRun);
            // Create a new document
            WordDocument doc = new WordDocument(paragraph);
            // Export the DOCX file
            doc.SaveAs("document.docx");
        }
    }
}
using IronWord;
using IronWord.Models;
namespace ConsoleApp1
{
    internal class Program
    {
        static void Main(string [] args)
        {
            // Create a text run
            TextRun textRun = new TextRun("Hello, IronPdf");
            Paragraph paragraph = new Paragraph();
            paragraph.AddTextRun(textRun);
            // Create a new document
            WordDocument doc = new WordDocument(paragraph);
            // Export the DOCX file
            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
			Dim textRun As New TextRun("Hello, IronPdf")
			Dim paragraph As New Paragraph()
			paragraph.AddTextRun(textRun)
			' Create a new document
			Dim doc As New WordDocument(paragraph)
			' Export the DOCX file
			doc.SaveAs("document.docx")
		End Sub
	End Class
End Namespace
VB   C#

Nous pouvons ajouter du texte au document à l'aide de la classe TextRun, qui nous permet de passer le texte dans l'objet paragraphe à l'aide de la méthode AddTextRun. Nous créons ensuite un nouvel objet WordDocument pour créer un nouveau fichier DOCX. Ensuite, en utilisant la méthode SaveAs, nous pouvons enregistrer le nouveau document DOCX à l'emplacement souhaité. Voici le résultat généré par le code ci-dessus.

Comment créer un fichier DOCX en C# : Figure 6 - PDF produit à partir du code précédent

Pour en savoir plus sur le code IronWord, consultez le site suivant ici.

Conclusion

Dans ce guide, nous avons vu comment utiliser C# pour générer un fichier de document DOCX. Les principes fondamentaux du format DOCX ont été abordés, ainsi que le SDK Open XML et la bibliothèque DocX, et des exemples de leur utilisation pour générer, éditer et enregistrer des fichiers DOCX ont été donnés.

L'ensemble de ces outils et méthodes vous permettra de vous acquitter de diverses tâches de création de documents dans le cadre de vos projets C#. L'apprentissage de la production de documents en C# est une compétence utile qui vous aidera dans diverses situations, qu'il s'agisse d'automatiser la génération de rapports, de développer des systèmes de gestion de documents ou simplement de 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 Word (DOCX) dans leurs applications en toute simplicité. 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 à de nouveaux documents Word est simplifié.

IronWord est une $749 lorsqu'elle sort pour la première fois. En outre, les clients qui s'acquittent d'une cotisation d'un an peuvent bénéficier d'une assistance et de mises à jour sur les produits. IronWord propose, moyennant paiement, une défense contre la redistribution effrénée. Pour en savoir plus sur le coût approximatif, consultez le site suivant page. Pour en savoir plus sur Iron Software, cliquez sur le lien suivant link.

< PRÉCÉDENT
Comment réaliser l'automatisation des mots en C#
SUIVANT >
Comment créer un document Word par programmation en VB .NET