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: Une Bibliothèque Word C#

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"

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

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

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

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

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

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 propriété IsItalic comme true, indiquant que le texte doit être en italique.
3. Nous faisons de même pour la variable boldText, en assignant true à la propriété IsBold.
4. Nous attribuons ensuite les variables TextStyle à leurs variables respectives Text.
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 en utilisant 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

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 .