Passer au contenu du pied de page
UTILISATION D'IRONWORD

VS 2022 Créer des Nouveaux Documents Word par Programmation (Tutoriel)

Les documents deviennent de plus en plus numériques à l'ère numérique. Dans le monde des affaires, les documents sont souvent associés à Microsoft Word et à son format de fichier. La rédaction et la modification de documents Microsoft Word sont devenues essentielles à la circulation de l'information dans les grandes organisations. Cependant, la création et la modification manuelles de documents peuvent être un processus fastidieux ; Automatiser la génération de documents Word par programmation n'est pas non plus une mince affaire, car de nombreuses bibliothèques open source dépendent de Microsoft Office Word.

Cependant, la gestion et la création de documents Word ne doivent pas nécessairement être aussi difficiles. IronWord est une bibliothèque Word en C# qui ne dépend pas de Microsoft Office Word et permet aux utilisateurs de personnaliser l'intégralité du document, tout en permettant la génération de documents et la création de modèles de documents par programmation.

Dans le tutoriel d'aujourd'hui, j'expliquerai brièvement comment créer un document Microsoft Word par programmation en utilisant IronWord et fournirai de brefs exemples.

IronWord : Bibliothèque de mots AC#

IronWord est une bibliothèque Docx C# exceptionnellement fiable et conviviale qui permet aux développeurs de créer et de modifier des documents Word en C#, sans avoir besoin de dépendances traditionnelles telles que Microsoft Office ou Word Interop. De plus, elle bénéficie d'une documentation complète et prend entièrement en charge .NET 8, 7, 6, Framework, Core et Azure, ce qui la rend compatible avec la plupart des applications. Ce niveau de flexibilité en fait un excellent choix pour toute application que vous pourriez avoir à gérer.

Mise en place de l'environnement

Dans cet exemple, nous allons créer une application console à l'aide de Visual Studio et montrer comment créer des documents Word vierges et les manipuler à l'aide de la bibliothèque IronWord. Avant de passer à l'étape suivante, assurez-vous d'avoir installé Visual Studio.

Commençons par créer une nouvelle application console.

Ensuite, indiquez un nom de projet et enregistrez l'emplacement, comme indiqué ci-dessous.

Enfin, sélectionnez le framework souhaité.

Installation de la bibliothèque Word C

Après avoir créé l'application console vierge, nous téléchargerons IronWord via le gestionnaire de packages NuGet.

Cliquez sur " Gérer les packages NuGet ", puis recherchez IronWord dans l'onglet " Parcourir ", comme indiqué ci-dessous.

Ensuite, installez-le sur le projet nouvellement créé.

Vous pouvez également saisir la commande suivante dans l'invite de commandes pour installer IronWord.

Install-Package IronWord

Maintenant que tout est configuré et prêt à l'emploi, passons à un exemple de création de documents Word.

Clé de licence

Veuillez noter qu'IronWord nécessite une clé de licence pour fonctionner. Vous pouvez obtenir une clé dans le cadre d'un essai gratuit en visitant ce lien.

// Replace the license key variable with the trial key you obtained
IronWord.License.LicenseKey = "REPLACE-WITH-YOUR-KEY";
// Replace the license key variable with the trial key you obtained
IronWord.License.LicenseKey = "REPLACE-WITH-YOUR-KEY";
' Replace the license key variable with the trial key you obtained
IronWord.License.LicenseKey = "REPLACE-WITH-YOUR-KEY"
$vbLabelText   $csharpLabel

Après avoir reçu une clé d'essai, définissez cette variable dans votre projet.

Création d'un nouveau document Word

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Create a textrun
        Text textRun = new Text("Sample text");
        Paragraph paragraph = new Paragraph();
        paragraph.AddChild(textRun);

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

        // Export docx
        doc.SaveAs("document.docx");
    }
}
using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Create a textrun
        Text textRun = new Text("Sample text");
        Paragraph paragraph = new Paragraph();
        paragraph.AddChild(textRun);

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

        // Export docx
        doc.SaveAs("document.docx");
    }
}
Imports IronWord
Imports IronWord.Models

Friend Class Program
	Shared Sub Main()
		' Create a textrun
		Dim textRun As New Text("Sample text")
		Dim paragraph As New Paragraph()
		paragraph.AddChild(textRun)

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

		' Export docx
		doc.SaveAs("document.docx")
	End Sub
End Class
$vbLabelText   $csharpLabel

! VS 2022 Créer des documents Word par programmation (Tutoriel) : Figure 6 - Résultat de l'exemple ci-dessus

Explication

  1. Tout d'abord, nous importons la bibliothèque IronWord et ses modèles dans l'exemple de code.
  2. Nous créons une nouvelle variable Text . Cette variable nous permet d'ajouter du texte au document Word.
  3. Nous ajoutons ensuite le textRun à un Paragraph . Cela nous permet de manipuler facilement le texte en faisant la distinction entre les deux.
  4. Nous transmettons le paramètre paragraph à une nouvelle classe WordDocument pour créer un nouvel objet document.
  5. Enfin, nous enregistrons le document sous le nom " document.docx " dans un fichier Word.

Dans l'exemple précédent, nous avons créé un document Word contenant du texte simple. Prenons un exemple avec des fonctionnalités plus avancées, comme la personnalisation du texte et l'ajout d'effets de texte.

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Ensure to set up the license key
        IronWord.License.LicenseKey = "YOUR-KEY";

        // Load an existing docx
        WordDocument doc = new WordDocument("document.docx");

        // Create sample texts with styles
        Text introText = new Text("This is an example paragraph with italic and bold styling.");
        TextStyle italicStyle = new TextStyle()
        {
            IsItalic = true
        };
        Text italicText = new Text("Italic example sentence.");
        italicText.Style = italicStyle;

        TextStyle boldStyle = new TextStyle()
        {
            IsBold = true
        };
        Text boldText = new Text("Bold example sentence.");
        boldText.Style = boldStyle;

        // Create a paragraph and add texts
        Paragraph paragraph = new Paragraph();
        paragraph.AddText(introText);
        paragraph.AddText(italicText);
        paragraph.AddText(boldText);

        // Add paragraph to the document
        doc.AddParagraph(paragraph);

        // Export the document
        doc.SaveAs("save_document.docx");
    }
}
using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Ensure to set up the license key
        IronWord.License.LicenseKey = "YOUR-KEY";

        // Load an existing docx
        WordDocument doc = new WordDocument("document.docx");

        // Create sample texts with styles
        Text introText = new Text("This is an example paragraph with italic and bold styling.");
        TextStyle italicStyle = new TextStyle()
        {
            IsItalic = true
        };
        Text italicText = new Text("Italic example sentence.");
        italicText.Style = italicStyle;

        TextStyle boldStyle = new TextStyle()
        {
            IsBold = true
        };
        Text boldText = new Text("Bold example sentence.");
        boldText.Style = boldStyle;

        // Create a paragraph and add texts
        Paragraph paragraph = new Paragraph();
        paragraph.AddText(introText);
        paragraph.AddText(italicText);
        paragraph.AddText(boldText);

        // Add paragraph to the document
        doc.AddParagraph(paragraph);

        // Export the document
        doc.SaveAs("save_document.docx");
    }
}
Imports IronWord
Imports IronWord.Models

Friend Class Program
	Shared Sub Main()
		' Ensure to set up the license key
		IronWord.License.LicenseKey = "YOUR-KEY"

		' Load an existing docx
		Dim doc As New WordDocument("document.docx")

		' Create sample texts with styles
		Dim introText As New Text("This is an example paragraph with italic and bold styling.")
		Dim italicStyle As New TextStyle() With {.IsItalic = True}
		Dim italicText As New Text("Italic example sentence.")
		italicText.Style = italicStyle

		Dim boldStyle As New TextStyle() With {.IsBold = True}
		Dim boldText As New Text("Bold example sentence.")
		boldText.Style = boldStyle

		' Create a paragraph and add texts
		Dim paragraph As New Paragraph()
		paragraph.AddText(introText)
		paragraph.AddText(italicText)
		paragraph.AddText(boldText)

		' Add paragraph to the document
		doc.AddParagraph(paragraph)

		' Export the document
		doc.SaveAs("save_document.docx")
	End Sub
End Class
$vbLabelText   $csharpLabel

! VS 2022 Créer des documents Word par programmation (Tutoriel) : Figure 7 - Résultat de l'exemple de code ci-dessus

Explication du code

  1. Comme dans l'exemple ci-dessus, nous créons l'objet Text et ajoutons le texte d'exemple pour le document.
  2. Nous créons ensuite un nouvel objet TextStyle et attribuons la true à la propriété IsItalic , indiquant ainsi que le texte doit être en italique.
  3. Nous procédons de la même manière pour la variable boldText , en attribuant true à la propriété IsBold .
  4. Nous assignons ensuite les variables TextStyle à leurs variables Text respectives.
  5. Nous créons une variable Paragraph et appelons la méthode AddText pour ajouter le texte en italique et en gras.
  6. Nous ajoutons le paragraphe au document à l'aide de la méthode AddParagraph .
  7. Enfin, nous enregistrons le document sous le nom " save_document.docx ".

L'exemple ci-dessus illustre les polices et les styles que les développeurs peuvent utiliser avec IronWord. Outre les effets de texte en italique et en gras, IronWord offre également d'autres fonctionnalités pour garantir aux développeurs toutes les options nécessaires à la création de documents Word uniques dans divers scénarios.

Conclusion

! VS 2022 Créer des documents Word par programmation (Tutoriel) : Figure 8 - Informations sur la licence IronWord

Nos démonstrations ont montré à quel point il est facile d'utiliser la bibliothèque IronWord pour créer des documents Word en C# par programmation. La flexibilité et l'évolutivité de cette bibliothèque en font un outil précieux pour les développeurs dans des scénarios concrets, comme la personnalisation du texte, de la police et du style dans un document Word. Comprendre comment Word s'intègre à d'autres applications offre aux développeurs des solutions supplémentaires à leurs problèmes.

IronWord propose une licence d'essai gratuite .

Questions Fréquemment Posées

Comment puis-je créer un document Microsoft Word par programmation en C# ?

Vous pouvez créer un document Microsoft Word par programmation en C# en utilisant la bibliothèque IronWord. Initialisez un objet WordDocument, ajoutez le contenu nécessaire et utilisez la méthode SaveAs pour l'exporter en tant que fichier .docx.

Quels sont les avantages d'utiliser IronWord par rapport à Microsoft Office Interop pour la création de documents Word ?

IronWord offre des avantages par rapport à Microsoft Office Interop en ne nécessitant pas d'installations de Microsoft Office, offrant une plus grande flexibilité et une intégration plus facile sur différentes plateformes sans dépendance à Office.

Comment installer IronWord dans Visual Studio ?

Pour installer IronWord dans Visual Studio, ouvrez le gestionnaire de packages NuGet, recherchez IronWord et installez-le dans votre projet. Alternativement, utilisez la ligne de commande avec Install-Package IronWord.

Puis-je formater du texte dans un document Word en utilisant IronWord ?

Oui, vous pouvez formater du texte dans un document Word en utilisant IronWord en utilisant l'objet TextStyle pour appliquer divers styles comme l'italique et le gras aux éléments de texte.

IronWord est-il compatible avec .NET et Azure ?

Oui, IronWord est entièrement compatible avec .NET 8, 7, 6, Framework, Core et Azure, ce qui le rend polyvalent pour diverses applications.

Comment dépanner les problèmes d'installation avec IronWord ?

Si vous rencontrez des problèmes d'installation avec IronWord, assurez-vous que vous utilisez une version compatible de Visual Studio et .NET, et que votre gestionnaire de packages NuGet est à jour. Vérifiez votre connexion Internet et réessayez l'installation.

Qu'est-ce qui est nécessaire pour commencer à créer des documents Word avec IronWord ?

Pour commencer à créer des documents Word avec IronWord, importez la bibliothèque IronWord et ses modèles dans votre projet C#. Ensuite, initialisez un objet WordDocument pour commencer à construire votre document.

Comment puis-je ajouter des paragraphes à un document Word par programmation avec IronWord ?

Ajoutez des paragraphes à un document Word avec IronWord en créant Paragraph, ajoutant du texte, puis les intégrant au WordDocument.

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